home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-09 / cd600.zip / CATDOCS.ZIP / CATDISK.DOC next >
Text File  |  1992-01-01  |  209KB  |  5,017 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                            DISK CATALOG SYSTEM (CATDISK)
  20.  
  21.                                    USER'S GUIDE
  22.  
  23.  
  24.                                    Version 6.00
  25.  
  26.                                     Jan 1, 1992
  27.  
  28.  
  29.                      Copyright (C) 1986, 1991 By Rick Hillier
  30.  
  31.                                All Rights Reserved.
  32.  
  33.  
  34.  
  35.                                    _______
  36.                               ____|__     |               (tm)
  37.                            --|       |    |-------------------
  38.                              |   ____|__  |  Association of
  39.                              |  |       |_|  Shareware
  40.                              |__|   o   |    Professionals
  41.                            -----|   |   |---------------------
  42.                                 |___|___|    MEMBER
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                          T A B L E   O F   C O N T E N T S
  70.  
  71.       1. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  72.            Dedication . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  73.            Overview . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  74.            Features . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  75.            Licensing And Distribution . . . . . . . . . . . . . . . . . .   5
  76.            ASP . . .  . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  77.  
  78.       2. GETTING STARTED  . . . . . . . . . . . . . . . . . . . . . . . .   7
  79.            What You Should Have Received  . . . . . . . . . . . . . . . .   7
  80.            System Requirements  . . . . . . . . . . . . . . . . . . . . .   7
  81.            Initial Note On Archive Files  . . . . . . . . . . . . . . . .   7
  82.            Configuring CATDISK  . . . . . . . . . . . . . . . . . . . . .   8
  83.            Excluding Certain Files From Being Cataloged . . . . . . . . .  11
  84.            Color Customization  . . . . . . . . . . . . . . . . . . . . .  12
  85.            Default Settings . . . . . . . . . . . . . . . . . . . . . . .  12
  86.            Upgrading From V3.61 or Later  . . . . . . . . . . . . . . . .  13
  87.            Saving Your Configuration Settings . . . . . . . . . . . . . .  13
  88.            General Considerations When Configuring CATDISK  . . . . . . .  14
  89.            Sample Configurations  . . . . . . . . . . . . . . . . . . . .  15
  90.            IMPORTANT NOTE . . . . . . . . . . . . . . . . . . . . . . . .  16
  91.            Starting CATDISK . . . . . . . . . . . . . . . . . . . . . . .  17
  92.  
  93.       3. USING CATDISK  . . . . . . . . . . . . . . . . . . . . . . . . .  21
  94.            Using The Menus  . . . . . . . . . . . . . . . . . . . . . . .  21
  95.            Selecting A Volume ID From A List  . . . . . . . . . . . . . .  23
  96.            Option 1 - Set Drive For Cataloging  . . . . . . . . . . . . .  24
  97.            Option 2 - Set Current Catalog File  . . . . . . . . . . . . .  25
  98.            Option 3 - Settings And Toggles Menu . . . . . . . . . . . . .  26
  99.                1  - Set Drive For Cataloging  . . . . . . . . . . . . . .  26
  100.                2  - Pauses On/Off . . . . . . . . . . . . . . . . . . . .  26
  101.                3  - Change Printer Report Type  . . . . . . . . . . . . .  26
  102.                4  - File Comments On The Fly  . . . . . . . . . . . . . .  27
  103.                5  - Zip File Comment Copy . . . . . . . . . . . . . . . .  27
  104.                6  - Extract 4DOS/NDOS Comments  . . . . . . . . . . . . .  27
  105.                7  - Set Current Report Destination  . . . . . . . . . . .  27
  106.                8  - Activating/Deactivating Two Sided Printer Reports . .  28
  107.                9  - Archive Extract Setting . . . . . . . . . . . . . . .  28
  108.                0  - Comments When ZIPS Not Extracted  . . . . . . . . . .  29
  109.                F1 - Aliases On/Off  . . . . . . . . . . . . . . . . . . .  29
  110.               ESC - Return To Main Menu . . . . . . . . . . . . . . . . .  29
  111.              Option 4 - Labeling A Disk . . . . . . . . . . . . . . . . .  30
  112.              Option 5 - Cataloging A Disk . . . . . . . . . . . . . . . .  31
  113.              Option F1 - UnCataloging A Disk  . . . . . . . . . . . . . .  34
  114.              Option 6 - Change Comments By Volume ID  . . . . . . . . . .  35
  115.              Option 7 - Change Comments By Filespec . . . . . . . . . . .  37
  116.              Option 8 - Comment Files By Comment  . . . . . . . . . . . .  37
  117.              Option 9 - Import Comments From A Text File  . . . . . . . .  37
  118.              Option 0 - Reports And Inquiries Menu  . . . . . . . . . . .  40
  119.                Screen Based Reports . . . . . . . . . . . . . . . . . . .  40
  120.                Printer Based Reports  . . . . . . . . . . . . . . . . . .  41
  121.                Disk Based Reports . . . . . . . . . . . . . . . . . . . .  41
  122.                1 - Show Disk Summary  . . . . . . . . . . . . . . . . . .  42
  123.                2 - Files For A Volume . . . . . . . . . . . . . . . . . .  43
  124.                3 - Files For An Archive . . . . . . . . . . . . . . . . .  45
  125.                4 - Files By Filespec  . . . . . . . . . . . . . . . . . .  47
  126.                5 - Files By Comment . . . . . . . . . . . . . . . . . . .  49
  127.  
  128.  
  129.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  130.  
  131.                                       Page 1
  132.  
  133.  
  134.  
  135.                6 - Sorted Full File Listings  . . . . . . . . . . . . . .  50
  136.                7 - Unique Files Only  . . . . . . . . . . . . . . . . . .  50
  137.                8 - Duplicate Files Only . . . . . . . . . . . . . . . . .  50
  138.                9 - Volume Summary/Contents  . . . . . . . . . . . . . . .  51
  139.              Option <F2> - Shell To DOS . . . . . . . . . . . . . . . . .  52
  140.              Option <drive_letter> - Show Disk Directory  . . . . . . . .  53
  141.              Option ESC - Exit To DOS . . . . . . . . . . . . . . . . . .  53
  142.  
  143.         Appendix A - The Scroll Bar . . . . . . . . . . . . . . . . . . .  54
  144.         Appendix B - Archive Support  . . . . . . . . . . . . . . . . . .  55
  145.         Appendix C - Support And Updates  . . . . . . . . . . . . . . . .  57
  146.           Attention Out of Town CATDISK Users . . . . . . . . . . . . . .  57
  147.         Appendix D - Questions And Answers  . . . . . . . . . . . . . . .  59
  148.         Appendix E - CATLOOK Command Line Lookup Utility  . . . . . . . .  62
  149.         Appendix F - CATMGR - CATDISK Catalog Manager . . . . . . . . . .  63
  150.         Appendix G - DISKFILL - Optimal Disk Fill Utility . . . . . . . .  67
  151.         Appendix H - CATDISK Companion Programs . . . . . . . . . . . . .  72
  152.         Appendix I - CATDISK PLUS . . . . . . . . . . . . . . . . . . . .  74
  153.         Appendix J - Other Products Available . . . . . . . . . . . . . .  75
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  196.  
  197.                                       Page 2
  198.  
  199.  
  200.  
  201.                         1.  I N T R O D U C T I O N
  202.  
  203.  
  204.         DEDICATION
  205.  
  206.         This program is dedicated to the memory of my Grandfather, Earl Hillier
  207.         (Jan 1, 1909 - May 2, 1989).
  208.  
  209.  
  210.         OVERVIEW
  211.  
  212.         Overheard:  "I know I have that file in an archive on a disk SOMEWHERE!
  213.                     If only I could FIND it!"
  214.  
  215.         Sound familiar?  Many people I know are in this predicament.
  216.  
  217.         Enter CATDISK, the disk cataloging system.  CATDISK can help you
  218.         organize your disks in such a way that it is easy to find a file from
  219.         within a large collection by creating a collective directory of all the
  220.         files contained in your collection.  See the FEATURES section below for
  221.         a listing of CATDISK's capabilities.
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  262.  
  263.                                       Page 3
  264.  
  265.  
  266.  
  267.         FEATURES
  268.  
  269.         . Completely menu-driven and very easy to use.
  270.         . Easy to use configuration utility allows customization of many of the
  271.           program's features.
  272.         . All screen colors can be customized to your liking.
  273.         . Command line options can be stored in the DOS environment area
  274.           negating the need to memorize them.
  275.         . Cataloging/Uncataloging/Re-cataloging functions are completely
  276.           automatic.
  277.         . A disk volume label can be changed from within CATDISK.
  278.         . You can catalog a disk under an alias instead of the volume label.
  279.         . Can support up to 32,767 files or 2,000 disks per catalog,
  280.           whichever comes first.
  281.         . This limit can be reduced through the configuration utility to better
  282.           optimize memory usage.
  283.         . Supports multiple catalog files.
  284.         . CATMGR can be used to split/merge complete or partial catalog files.
  285.         . Supports sub-directories up to 32 levels deep with an upper limit of
  286.           256 directories per disk being cataloged.
  287.         . Able to read the directory contents of ARC, ARJ, DWC, HYP, LBR, LZH,
  288.           LZS,PAK, ZIP, and ZOO files.  See the appendix on ARCHIVE SUPPORT in
  289.           this user manual for further details.
  290.         . You can attach a 30 character comment to each file in the catalog,
  291.           which can be done either while cataloging a disk, or at a later time.
  292.         . Comments can be imported from an ASCII text file, such as a BBS
  293.           listing.
  294.         . Can read comments from ZIP, ZOO and DWC files.
  295.         . ARC, ARJ, DWC, HYP, LBR, LZH, LZS, PAK, ZIP, and ZOO file extraction
  296.           is optional and can be decided while running the program.
  297.         . Can extract resolution/color information from GIF (Graphics
  298.           Interchange Format) files and include it as the default comment.
  299.         . Can read 4DOS/NDOS directory comments and add them to your catalog.
  300.         . Summary report shows disk capacity, space used and space free on
  301.           each disk in the catalog to aid in optimization of disk usage.
  302.         . Files can be viewed by DOS wildcards, Volume ID, ARCHIVE ID, or by
  303.           keywords or phrases in the file comments.
  304.         . Reports can be sent to screen, printer, or disk file.
  305.         . Printer reports can be printed in a two-sided format to conserve
  306.           paper (this is, quite possibly, the first environmentally friendly
  307.           software product in terms of built-in reporting facilities).
  308.         . DISKFILL Optimal Disk Fill Utility automates offloading files to
  309.           floppies and uses a "best-fit" arrangement to minimize wasted disk
  310.           space.
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  328.  
  329.                                       Page 4
  330.  
  331.  
  332.  
  333.         LICENSING AND DISTRIBUTION
  334.  
  335.         CATDISK is copyright and has been released for distribution as
  336.         SHAREWARE.  Please note that a great deal of time and effort has been
  337.         invested in the development of this program.  You are granted a license
  338.         to try CATDISK for a reasonable trial period without risk.  If, after
  339.         this time, you find the program useful and intend to use it in managing
  340.         your disk collection, you are expected to register.
  341.  
  342.         The base registration fee is $25.  This will entitle you to continue to
  343.         use CATDISK beyond a reasonable trial period as well as entitle you to
  344.         program support.  You will find a registration form at the end of this
  345.         user manual that outlines the procedures for registering your copy of
  346.         the program.  Should you decide that you would like the latest release
  347.         (or a pending release if you already have the latest) appropriate
  348.         information is contained on the same form.
  349.  
  350.         Please keep in mind that I must have a registration form on file for
  351.         you before I can offer product support.
  352.  
  353.         Operators of electronic bulletin boards (Sysops) are encouraged to post
  354.         CATDISK for downloading by their users.
  355.  
  356.         CATDISK may be uploaded to and downloaded from commercial systems such
  357.         as CompuServe, the Source, and BIX, so long as the only charge paid by
  358.         the subscriber is for on-line time and there is no charge for the
  359.         program.  Those copying, sharing, and/or electronically transmitting
  360.         the program are required not to delete or modify the copyright notice
  361.         and restrictive notices from the program or documentation; anyone doing
  362.         so will be treated as a contributory copyright violator.
  363.  
  364.         If you are passing this program on to others, uploading it to a
  365.         bulletin board system, or including it in a users group library, do not
  366.         separate the files contained in the distribution archive - pass the
  367.         entire archive on to the intended party.  This ensures that those who
  368.         receive the program will have all the correct configuration utilities
  369.         and documentation necessary to get CATDISK up and running quickly.  A
  370.         listing of what files you should have and the purpose of each is listed
  371.         later in this manual.
  372.  
  373.         The CATDISK documentation may not be modified by users. The program may
  374.         not be separated from the documentation when distributed.  Printed or
  375.         Photocopies ("Xeroxed") copies of the CATDISK documentation (i.e., this
  376.         manual) may not be distributed or sold without the written permission
  377.         of the author.
  378.  
  379.         No other person other than the author, Rick Hillier, may accept payment
  380.         or royalties for this program.
  381.  
  382.         This license to use CATDISK does NOT include the right to distribute or
  383.         sell CATDISK.  Distribution terms are detailed in the file VENDOR.DOC
  384.         which is included with this package.
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  394.  
  395.                                       Page 5
  396.  
  397.  
  398.  
  399.         ASP
  400.  
  401.         This program is produced by a member of the Association of Shareware
  402.         Professionals (ASP).  ASP wants to make sure that the shareware
  403.         principle works for you.  If you are unable to resolve a
  404.         shareware-related problem with an ASP member by contacting the member
  405.         directly, ASP may be able to help.  The ASP Ombudsman can help you
  406.         resolve a dispute or problem with an ASP member, but does not provide
  407.         technical support for members' products.  Please write to the ASP
  408.         Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve
  409.         message via CompuServe mail to ASP Ombudsman 70007,3536
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  460.  
  461.                                       Page 6
  462.  
  463.  
  464.  
  465.                            2.  G E T T I N G   S T A R T E D
  466.  
  467.         WHAT YOU SHOULD HAVE RECEIVED
  468.  
  469.         CATDISK is distributed in the form of a self-extracting executable file
  470.         created with Haruyasu Yokizaki's LHA utility.   This file should
  471.         contain three files which are as follows:
  472.  
  473.         README.1ST   - Urgent program notes - IMPORTANT -- READ THIS FILE!
  474.  
  475.         CATPROGS.EXE - A self-extracting archive containing the CATDISK program
  476.                        files as follows:
  477.  
  478.            CATDISK.EXE  - The CATDISK program file.
  479.            CATLOOK.EXE  - The CATDISK command line utility (lookup program).
  480.            CATMGR.EXE   - The CATDISK catalog file manager (split/merge/delete/
  481.                           copy utility).
  482.            DISKFILL.EXE - An optimal disk fill utility.
  483.            CDISKCFG.EXE - The CATDISK configuration program.
  484.            CDISKCVT.EXE - Conversion utility for converting old CATDISK files
  485.                           to the newest format - See the README.1ST file before
  486.                           running.
  487.            CLEANCAT.EXE - Cleanup utility for catalog entries containing volume
  488.                           labels containing null characters - See the
  489.                           README.1ST file before running.
  490.  
  491.         CATDOCS.EXE  - A self-extracting archive containing the CATDISK
  492.                        documentation files as follows:
  493.  
  494.            PRINTDOC.EXE - A utility program to print the various CATDISK
  495.                           documentation files.  See README.1ST for details.
  496.            CATDISK.DOC  - The manual you are now reading.
  497.            CATDISK.HST  - Revision history for CATDISK since its initial
  498.                           release in October 1986.
  499.            REGISTER.FRM - The registration form for this product.
  500.            SITE.LIC     - The site license registration form for this product.
  501.            VENDOR.DOC   - Vendors must read this agreement and use the attached
  502.                           form for obtaining permission to distribute CATDISK.
  503.  
  504.         To extract the files, just run CATPROGS.EXE and/or CATDOCS.EXE and the
  505.         files will be automatically extracted to the current directory.
  506.  
  507.         SYSTEM REQUIREMENTS
  508.  
  509.         . IBM PC/XT/AT or PS/2 or true compatible computer.
  510.         . DOS V2.00 or above.
  511.         . At least one floppy disk drive (Hard Drive Highly Recommended).
  512.         . 320K RAM - if more is available, CATDISK will have greater internal
  513.                      capacity for reading new files off of the disks being
  514.                      cataloged and will run more efficiently.
  515.  
  516.  
  517.         INITIAL NOTE ON ARCHIVE FILES
  518.  
  519.         At various points in this user manual, references to ARCHIVE files are
  520.         made.  This is a collective term describing a file that actually
  521.         contains more than one file.  The contained files may or may not be
  522.         compressed.  Currently, this refers to ARC, ARJ, DWC, HYP, LBR, LZH,
  523.         LZS, PAK, ZIP and ZOO files.
  524.  
  525.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  526.  
  527.                                       Page 7
  528.  
  529.  
  530.  
  531.         CONFIGURING CATDISK
  532.  
  533.         Many features of CATDISK may be permanently set from the configuration
  534.         program, CDISKCFG.EXE.  When you start this program, please make sure
  535.         that the correct versions of the program files CATDISK.EXE, and
  536.         CATLOOK.EXE are in the current drive and directory, otherwise you will
  537.         get an error message.
  538.  
  539.         There are several utilities available that allow you to compress an
  540.         executable file such that it remains executable, but takes up less room
  541.         on your disk.  Examples of such programs are PKLITE and LZEXE.  If you
  542.         use such programs on CATDISK.EXE and CATLOOK.EXE, CDISKCFG will not be
  543.         able to find the configuration information in those two files.  Once
  544.         you've configured CATDISK to your liking, it's okay to compress the two
  545.         files after making copies of the originals.
  546.  
  547.         Upon startup, the configuration program will read the current settings
  548.         defined in "CATDISK.EXE", after which, the configuration screen will be
  549.         presented.  You may change any given item on this screen by using the
  550.         <Cursor UP> and <Cursor DOWN> keys to highlight the title of the
  551.         desired field.  The bottom portion of the screen will contain any
  552.         additional information as well as any instructions on how to change the
  553.         selected item.
  554.  
  555.         A discussion of the 10 items on this list follows:
  556.  
  557.          1) SCREEN UPDATE METHOD
  558.  
  559.             You may choose between having your screen updated by using your
  560.             computer's built in BIOS routines, or by using a faster DIRECT
  561.             screen update method.  Using the BIOS is much slower than using
  562.             direct access, but maintains compatibility with such operating
  563.             environments as TopView, Desqview, and DoubleDOS.
  564.             Choosing DIRECT screen access is much quicker, but will be
  565.             incompatible with most multitasking programs such as the above
  566.             mentioned due to the fact that they cannot handle "ill-behaved"
  567.             programs that write directly to the screen.
  568.  
  569.             If you chose DIRECT screen access, a second test is made if you
  570.             have a GRAPHICS display connected in your system.  Some video
  571.             adapters have the nasty side effect of producing static, or "snow"
  572.             when the video memory is accessed directly.  This test will do
  573.             multiple direct access to the video ram on your graphics adapter.
  574.             When you hit a key to stop the test, you will be asked if you saw
  575.             static on the screen.
  576.  
  577.             If you answer "Y" to the prompt, CATDISK will check for horizontal
  578.             retrace before writing to the display.  This will result in a
  579.             slightly slower screen response than normal, but it is almost
  580.             negligible.
  581.  
  582.             If you are not running under a multitasking system, or are using
  583.             DoubleDos in dual screen mode, I would recommend that you use
  584.             DIRECT screen access, as it's much quicker.
  585.  
  586.          2) COLOR OR B & W
  587.  
  588.             This option is self-explanatory.  The appearance of the setup
  589.             screen will depend on the setting of this field.
  590.  
  591.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  592.  
  593.                                       Page 8
  594.  
  595.  
  596.  
  597.          3) DISK CACHE SIZE
  598.  
  599.             This field will enable you to set the DISK CACHE size. Setting it
  600.             to zero will disable the cache (i.e. turn the feature off).
  601.  
  602.             Setting it to a number greater then zero will turn it on and will
  603.             enable CATDISK to keep the most recently read sectors of the
  604.             CATALOG FILES in memory, resulting in much faster scans through the
  605.             catalog file when looking for a group of files.
  606.  
  607.             Some hard disks use their own device driver, and are incompatible
  608.             with this caching method.  If this is the case, CATDISK will warn
  609.             you of this condition if caching is enabled, but is incompatible
  610.             with your hard disk.  Under these circumstances, the caching
  611.             feature will be turned off during that program run... use this
  612.             configuration option to permanently disable the cache and eliminate
  613.             the warning at each startup.
  614.  
  615.             If you already have a resident disk cache loaded in your system, DO
  616.             NOT USE CATDISK'S BUILT IN CACHE!!!  The two systems will conflict
  617.             with each other and will probably cause damage to your catalog
  618.             files.
  619.  
  620.          4) NUMBER OF LINES PER PAGE
  621.  
  622.             The number of lines per page field will enable you to tell CATDISK
  623.             the number of lines of data (EXCLUDING headings) that it should
  624.             place on each page of printer or disk output.  This may be any
  625.             number between 0 and 255.  Entering zero will disable page breaking
  626.             and the output will be presented in a continuous stream with one
  627.             title at the top.
  628.  
  629.          5) PRINTER STARTUP STRING
  630.  
  631.             The printer start up string is a series of ASCII codes (entered
  632.             here as their ASCII VALUES) that will tailor your reports to the
  633.             format you desire.  For example, I use an Epson printer and like to
  634.             set it to 1/8" spacing and get 80 report lines per page.  To do
  635.             this, I send a startup string of "<Esc> <0>" to set this print
  636.             mode.  To enter this string in the configuration program, I would
  637.             enter it as "027 048" without the quotes.  The numbers are simply
  638.             the ASCII values of the characters I wish to send.  If you have a
  639.             setup string entered here and wish to clear it, simply hit <Return>
  640.             in response to the prompt in the bottom area of the screen.
  641.  
  642.          6) PRINTER FINISHING STRING
  643.  
  644.             The printer finishing string is commonly used to reverse the
  645.             startup string entered above and is entered in exactly the same
  646.             way.  In the example above, I would use "<Esc> <2>", which would be
  647.             entered as "027 050" without the quotes.  If you have a setup
  648.             string entered here and wish to clear it, simple hit <Return> in
  649.             response to the prompt in the bottom area of the screen.
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  658.  
  659.                                       Page 9
  660.  
  661.  
  662.  
  663.          7) DEFAULT ARCHIVE EXTRACT STATE
  664.  
  665.             This will control the way CATDISK handles any ARCHIVE files that
  666.             it might encounter when cataloging your disks.
  667.  
  668.             If you set it to OFF, CATDISK will NOT extract any archive files
  669.             that it finds on your disks.
  670.  
  671.             If you set it to ON, CATDISK will expand EVERY ARCHIVE file that it
  672.             finds on your disks.
  673.  
  674.             If you set it to QUERY, CATDISK will ask you for permission to
  675.             expand an ARCHIVE file each time it encounters one.
  676.  
  677.             This can be changed temporarily while running CATDISK.
  678.  
  679.          8) DEFAULT CATALOG DRIVE
  680.  
  681.             The default catalog drive is the drive that CATDISK will assume you
  682.             wish to use for labeling disks and reading them for cataloging
  683.             purposes.  This drive may still be changed at startup time (see
  684.             STARTING CATDISK), or from the menu when catdisk is running.
  685.  
  686.             If you are running on single floppy based system, I would recommend
  687.             that you set this drive to the same drive ID that CATDISK will be
  688.             run from.  CATDISK will prompt you to enter the appropriate disks
  689.             at the appropriate time, and will eliminate potential problems with
  690.             the disk caching feature if enabled (See the file README.1ST).
  691.  
  692.          9) CATALOG FILE DIRECTORY
  693.  
  694.             The catalog file directory is the location in your system that
  695.             CATDISK will look for and create its catalog files.  This path may
  696.             contain a drive designator, so that the catalog files may reside on
  697.             a different drive than CATDISK itself, such as a ramdisk (in this
  698.             case don't forget to copy the files to a real disk before you turn
  699.             off or reboot your machine).
  700.  
  701.             If this field is blank, the default drive and directory will be
  702.             used.
  703.  
  704.         10) DISKS/FILES PER CATALOG
  705.  
  706.             The maximum number of disks and files per catalog is simply that.
  707.             When CATDISK starts, it allocates its work space according to this
  708.             setting.  There are currently four possible settings; which one you
  709.             pick is largely dependent upon the environment in which CATDISK is
  710.             to be run.
  711.  
  712.                 These settings are:       DISKS       # FILES
  713.  
  714.                                            2000     32767 (32K)
  715.                                            1500     24576 (24K)
  716.                                            1000     16384 (16K)
  717.                                             500      8192 ( 8K)
  718.  
  719.  
  720.  
  721.  
  722.  
  723.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  724.  
  725.                                       Page 10
  726.  
  727.  
  728.  
  729.         EXCLUDING CERTAIN FILES FROM BEING CATALOGED
  730.  
  731.         There are circumstances where it is desirable to have CATDISK skip over
  732.         certain files while reading in directory information for cataloging
  733.         purposes.  A good example of this may be a situation where the utility
  734.         FILEINFO (from The Norton Utilities) may be used to maintain lists of
  735.         file comments.  This information is stored in each directory in a file
  736.         called FILEINFO.FI, and, if you catalog many diskettes containing this
  737.         file, you will end up with the same filename listed in your catalog
  738.         many times.
  739.  
  740.         Another example would be many DOS system diskettes that contain IO.SYS,
  741.         MSDOS.SYS, COMMAND.COM and AUTOEXEC.BAT.
  742.  
  743.         There is a place in the configuration program where you can give
  744.         CATDISK a list of up to 20 wildcard specifications for files that you
  745.         do not want included in cataloging operations.  When CATDISK scans a
  746.         disk to be cataloged, any files matching one of the specifications in
  747.         the list will be ignored.
  748.  
  749.         One thing to note, though.  If you instruct CATDISK to skip archive
  750.         files, the directory information of those archives will still be
  751.         examined and included in the cataloging operation if appropriate.
  752.  
  753.         The uses for this feature are quite broad.
  754.  
  755.         You can change the list of filespecs to skip over by pressing <F7> from
  756.         the main configuration screen.  You will then see a screen where you
  757.         can fill in up to 20 filespecs that CATDISK should ignore when
  758.         performing cataloging operations.  To change a filespec, simply use the
  759.         cursor keys to move to the desired filespec and type in the new
  760.         information for that area.
  761.  
  762.         To clear out an existing spec, just fill the area with spaces.
  763.  
  764.         When you are finished modifying the list, press <Esc> to return to the
  765.         main configuration screen.
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  790.  
  791.                                       Page 11
  792.  
  793.  
  794.  
  795.         COLOR CUSTOMIZATION
  796.  
  797.         If you are running on a color monitor and have the color setting in the
  798.         main configuration set to COLOR, you may set your own screen colors if
  799.         you happen to dislike the color scheme that comes with CATDISK.  To do
  800.         so, simply hit <F9> from the configuration screen and follow the menus.
  801.         Once you have selected this option, you will see a menu that will allow
  802.         you to select some general colors such as screen background and border
  803.         color (CGA type displays only - EGA and VGA have no effect), as well as
  804.         an option to reset the author's (that's me!) colors should you really
  805.         make a mess of the color scheme and wish to start over.
  806.  
  807.         The other options will bring up menus that pertain to the various
  808.         screens that you might encounter in your usage of CATDISK.  When you
  809.         reach these, there will be an option available for each item that will
  810.         change its foreground or background color.  Selecting an option will
  811.         step you through the possible color range for that particular item.
  812.  
  813.         Sound confusing?  Try it for yourself... it's really quite easy.  For
  814.         starters, try setting everything to green on cyan <grin> (if you don't
  815.         have a strong stomach, don't bother).
  816.  
  817.         Once you have set all the fields to your desired settings, you may
  818.         instruct CDISKCFG to save the current settings by pressing <F10>.
  819.         CATDISK will save the appropriate information in the CATDISK.EXE and
  820.         CATLOOK.EXE program files and return to DOS.
  821.  
  822.         If you do not wish to save the changes you made, simply hit <Esc>, and
  823.         you will be returned to DOS, while the previous configuration will
  824.         remain unscathed.
  825.  
  826.  
  827.         DEFAULT SETTINGS
  828.  
  829.         CATDISK is shipped with the following default settings:
  830.  
  831.         1) Screen Update Method:              BIOS
  832.  
  833.         2) Color or B & W:                    B & W
  834.  
  835.         3) Disk Caching:                      0 K (Disabled)
  836.  
  837.         4) Output Lines Per Page:             58
  838.  
  839.         5) Printer Startup String:            Nothing
  840.  
  841.         6) Printer Finishing String:          Nothing
  842.  
  843.         7) Default ARCHIVE Extract State:     ON
  844.  
  845.         8) Catalog Drive:                     A:
  846.  
  847.         9) Catalog File Directory:            Default Drive and Directory
  848.  
  849.         10) Maximum Disks/Files per Catalog:  1000/16384
  850.  
  851.         11) Color Scheme:                     Authors Colors
  852.  
  853.  
  854.  
  855.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  856.  
  857.                                       Page 12
  858.  
  859.  
  860.  
  861.         UPGRADING FROM V3.61 OR LATER
  862.  
  863.         Before copying the new program files to your work disk, you might want
  864.         to rename the executable file from the previous installation
  865.         (CATDISK.COM or CATDISK.EXE) to another name.  The configuration
  866.         utility, CDISKCFG.EXE has the ability to read the configuration
  867.         information from the release that you were using for easy installation
  868.         into this release.  This can save you some time in setting the program
  869.         up for your preferences, particularly if you've customized all the
  870.         screen colors.
  871.  
  872.         Example - Upgrading from V4.50 to this release:
  873.  
  874.         Procedure:
  875.  
  876.         1)  Rename your old CATDISK.EXE to CAT450.EXE (this file holds the
  877.             configuration information from the last installation.
  878.  
  879.         2)  Run the configuration utility, CDISKCFG.EXE.
  880.  
  881.         3)  Hit <F8>.  CDISKCFG will ask you for the file name of the old
  882.             program file.  Answer "CAT450.EXE" (without the quotes).  CDISKCFG
  883.             will search the given file for the appropriate configuration
  884.             information.  If successful, this information will be reflected in
  885.             the configuration options as displayed on the screen.  If you've
  886.             selected the wrong file, you will get an error message, and the old
  887.             settings will remain intact on the screen.
  888.  
  889.         4)  If successful, press <F10>, and the settings will be saved in the
  890.             current CATDISK release.
  891.  
  892.         5)  Delete CAT450.EXE - it's no longer needed.
  893.  
  894.  
  895.         SAVING YOUR CONFIGURATION SETTINGS
  896.  
  897.         When you have all of the configuration options set the way you want
  898.         them, simply press <F10> to save those changes to the various CATDISK
  899.         program files.
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  922.  
  923.                                       Page 13
  924.  
  925.  
  926.  
  927.         GENERAL CONSIDERATIONS WHEN CONFIGURING CATDISK
  928.  
  929.         When setting CATDISK up, there are a few things you should consider:
  930.  
  931.         If you have a hard disk, you should use it for maintaining your catalog
  932.         files (i.e. set your catalog file directory to somewhere on your hard
  933.         drive).
  934.  
  935.         If possible, set your video update method to DIRECT.  CATDISK runs
  936.         faster in this mode.
  937.  
  938.         If you are using a hard drive or a ram disk to hold your catalog files,
  939.         you should NOT use CATDISK's caching feature.  The cache built into
  940.         CATDISK is meant to aid those with floppy disk based systems when doing
  941.         multiple searches through the catalog file.  Using the cache while
  942.         updating a catalog files imposes additional overhead on the operation.
  943.         It is negligible on floppy based systems, as the bottleneck in the
  944.         operation is the disk itself - on hard drives, it is noticeable.  If
  945.         possible, using one of the commercially available disk caching systems
  946.         is recommended, as they incorporate features into their programs such
  947.         as being able to use extended and expanded memory and the like that are
  948.         not feasible to include in CATDISK.
  949.  
  950.         When setting your printer up for printing reports, try to set the
  951.         printer startup string such that the complete catalog listing (i.e.
  952.         files, stats and comments) can be printed.
  953.  
  954.         The best setting for the default ARCHIVE extract state is QUERY.  Many
  955.         archives do not need to be fully extracted as the name of the archive
  956.         filename itself is all that is necessary in order to identify what is
  957.         on that particular disk.  By using some discretion in deciding which
  958.         archive files need be extracted, you can dramatically reduce the size
  959.         of your catalog files (as well as the time needed to update and search
  960.         them).  Some however, need to be extracted (for example, MISC.ARC).
  961.         This setting gives you the best of both worlds.
  962.  
  963.         When setting the default drive and directory for your catalog files, be
  964.         sure and include it in your DOS PATH as well.  Although this is not
  965.         necessary, it will enable you to run CATDISK from anywhere in your
  966.         system without having to change to that directory before running
  967.         CATDISK.  Setting the PATH for this is only beneficial to those using
  968.         hard drives.
  969.  
  970.         When setting the maximum number of disks and files that can be
  971.         maintained in a catalog file, the best setting should be the LOWEST one
  972.         that will contain your largest catalog file.  This will maximize the
  973.         amount of free memory left over that CATDISK can use to store file
  974.         information being read from disks being cataloged, sorting information,
  975.         caching information, and the like.
  976.  
  977.         Keep in mind that, if you should have a catalog file grow to your set
  978.         maximum, you can always re-configure CATDISK (memory permitting, of
  979.         course) to accommodate a larger configuration, unless you are already
  980.         at the highest setting.  When you next run CATDISK after making these
  981.         changes, your catalog file will then be able to grow to the new
  982.         setting.
  983.  
  984.         If you are running on floppy drives, use the 8K setting for disks/files
  985.         per catalog.  Your files will never exceed this limitation.
  986.  
  987.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  988.  
  989.                                       Page 14
  990.  
  991.  
  992.  
  993.         SAMPLE CONFIGURATIONS
  994.  
  995.         Scenario:  One Hard Disk (C:) and a floppy drive:
  996.  
  997.                    Make a directory "C:\CATDISK" and copy the files CATDISK.EXE
  998.                    and CDISKCFG.EXE to it.  Set the configuration to:
  999.  
  1000.                    1) Screen Update Method:              <your option>
  1001.                    2) Color or B & W:                    <your option>
  1002.                    3) Disk Caching:                      0 K (Disabled)
  1003.                    4) Output Lines Per Page:             <your option>
  1004.                    5) Printer Startup String:            <your option>
  1005.                    6) Printer Finishing String:          <your option>
  1006.                    7) Default ARCHIVE Extract State:     <your option>
  1007.                    8) Catalog Drive:                     A:
  1008.                    9) Catalog File Directory:            C:\CATDISK
  1009.                    10) Maximum Disks/Files per Catalog:  <your option>
  1010.                    11) Color Scheme:                     <your option>
  1011.     
  1012.                    Add C:\CATDISK to the DOS PATH and you will be able to call
  1013.                    up CATDISK or CATLOOK from anywhere in your system.
  1014.  
  1015.         Scenario:  Two floppy drives:
  1016.  
  1017.                    Take a blank disk and copy the files CATDISK.EXE and
  1018.                    CDISKCFG.EXE to it.  This will be your CATDISK program disk.
  1019.                    Set the configuration to:
  1020.  
  1021.                    1) Screen Update Method:              <your option>
  1022.                    2) Color or B & W:                    <your option>
  1023.                    3) Disk Caching:                      <your option>
  1024.                    4) Output Lines Per Page:             <your option>
  1025.                    5) Printer Startup String:            <your option>
  1026.                    6) Printer Finishing String:          <your option>
  1027.                    7) Default ARCHIVE Extract State:     <your option>
  1028.                    8) Catalog Drive:                     A:
  1029.                    9) Catalog File Directory:            B:\
  1030.                    10) Maximum Disks/Files per Catalog:  500/8192
  1031.                    11) Color Scheme:                     <your option>
  1032.  
  1033.                    When starting CATDISK for the first time, insert the
  1034.                    program disk in drive A: and take a blank formatted disk and
  1035.                    insert it in drive B:.  This will be your data disk.  When
  1036.                    CATDISK has loaded and has displayed the title screen, you
  1037.                    may remove the CATDISK program disk from the A: drive.  This
  1038.                    will now be the drive from which disks being cataloged will
  1039.                    be read.
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1054.  
  1055.                                       Page 15
  1056.  
  1057.  
  1058.  
  1059.         Scenario:  One floppy drive:
  1060.  
  1061.                    Take a blank disk and copy the files CATDISK.EXE and
  1062.                    CDISKCFG.EXE to it.  This will be your CATDISK program disk.
  1063.                    Set the configuration to:
  1064.  
  1065.                    1) Screen Update Method:              <your option>
  1066.                    2) Color or B & W:                    <your option>
  1067.                    3) Disk Caching:                      <your option>
  1068.                    4) Output Lines Per Page:             <your option>
  1069.                    5) Printer Startup String:            <your option>
  1070.                    6) Printer Finishing String:          <your option>
  1071.                    7) Default ARCHIVE Extract State:     <your option>
  1072.                    8) Catalog Drive:                     A:
  1073.                    9) Catalog File Directory:            A:\
  1074.                    10) Maximum Disks/Files per Catalog:  500/8192
  1075.                    11) Color Scheme:                     <your option>
  1076.  
  1077.                    When starting CATDISK for the first time, insert the
  1078.                    program disk in drive A: and start CATDISK. You will need to
  1079.                    add the command line option /IP (initial pause - see later
  1080.                    in this manual).
  1081.  
  1082.                    Once CATDISK has loaded, it will pause and ask you to insert
  1083.                    your data disk.  If this is the first time you are running
  1084.                    CATDISK, use a blank formatted disk.
  1085.                    When you catalog a disk, you must first remove the data disk
  1086.                    and insert the disk to be cataloged BEFORE activating the
  1087.                    catalog function.  When CATDISK is done reading the disk, it
  1088.                    will ask you to re-insert the data disk.
  1089.  
  1090.  
  1091.         IMPORTANT NOTE
  1092.  
  1093.         If you are running CATDISK on a single drive system, I would recommend
  1094.         the above configuration for two reasons, even though DOS can make the
  1095.         one drive act like A: and B:.
  1096.  
  1097.         1) Perhaps the most important reason; if you've activated the disk
  1098.            caching feature, is that failure to do so may cause a loss of data
  1099.            on disks other than your data disk, particularly when you label a
  1100.            disk.  The reason being that the cache built into CATDISK references
  1101.            the PHYSICAL hardware, not the logical drive that DOS creates (i.e.
  1102.            A: and B: use the SAME piece of equipment).
  1103.  
  1104.            By setting CATDISK to the above configuration, it will be aware that
  1105.            the above situation exists and take the correct action when carrying
  1106.            out critical functions.
  1107.  
  1108.         2) This will allow CATDISK to prompt you for the appropriate disks,
  1109.            thus avoiding the DOS prompt "Insert disk for drive B:" and the
  1110.            like.
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1120.  
  1121.                                       Page 16
  1122.  
  1123.  
  1124.  
  1125.         STARTING CATDISK
  1126.  
  1127.         CATDISK is started from the DOS command line by issuing the following:
  1128.  
  1129.         CATDISK parameters
  1130.  
  1131.         - where parameters may include any of the following:
  1132.  
  1133.              /NP        - Specifying this command line option will cause
  1134.                           CATDISK to eliminate the pause after cataloging/
  1135.                           un-cataloging a disk.  It will also eliminate the
  1136.                           "Insert a disk in drive X:" prompt unless it is
  1137.                           absolutely necessary.
  1138.  
  1139.              /NW        - Under normal circumstances, when you catalog a
  1140.                           disk containing a Volume ID that already exists
  1141.                           in the current catalog, CATDISK will issue a
  1142.                           warning to that effect, and will ask you for
  1143.                           verification before proceeding to catalog that disk
  1144.                           The reason behind this is that there is always the
  1145.                           possibility of two different disks having the same
  1146.                           Volume ID.  Cataloging one would mean that the files
  1147.                           from the other would be un-cataloged in the same
  1148.                           process.
  1149.  
  1150.                           If you specify the /NW option on the command line,
  1151.                           this warning will be suppressed, and the disk will
  1152.                           be cataloged without further delay.
  1153.  
  1154.                           This option will also disable CATDISK's warning
  1155.                           before creating any new catalog files when the
  1156.                           current catalog file is changed via CATDISK's menus
  1157.                           to a catalog set that does not exist.
  1158.  
  1159.              /NS        - Suppress status indicators during processing.  This
  1160.                           speeds up processing time.  Status indicators are
  1161.                           there simply to indicate that the computer is
  1162.                           actually doing something useful.  Try it either way
  1163.                           and set it to your liking.
  1164.  
  1165.              /AC        - Turn the auto comment feature ON at startup.
  1166.                           Normally, CATDISK, upon completion of cataloging a
  1167.                           group of files from a disk will immediately
  1168.                           return to the menu.  Activating this feature from
  1169.                           the command line (or from the menu) will cause
  1170.                           CATDISK to proceed to the section where you may
  1171.                           add/modify the file comments for the volume that
  1172.                           you just cataloged.
  1173.  
  1174.              /SD        - CATDISK can display screen information for your
  1175.                           catalog in two different formats.  The default is
  1176.                           to show the Filename, Volume ID, Arc ID, size,
  1177.                           date, time and attributes for each record.  There
  1178.                           is a second display format that omits the file
  1179.                           attributes, but shows the sub-directory that the
  1180.                           file occupies on its disk.  Setting this option
  1181.                           will make the second format the starting report
  1182.                           type.
  1183.  
  1184.  
  1185.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1186.  
  1187.                                       Page 17
  1188.  
  1189.  
  1190.  
  1191.              /Ffilename - The default filename that CATDISK uses is "CATDISK"
  1192.                           which may be overridden with this parameter.
  1193.                           Note that there is no space between the /F and the
  1194.                           filename.
  1195.  
  1196.                           If you specify /F? on the command line, CATDISK will
  1197.                           bring up a point and shoot selection menu of all of
  1198.                           the catalogs it detected in your catalog file
  1199.                           directory.  If none are found, an error message will
  1200.                           be displayed and you will be returned to DOS.
  1201.                           Hitting the <Esc> key from within this list will also
  1202.                           cause you to be returned immediately to DOS.
  1203.  
  1204.              /CO        - similar to above, but the third display format that
  1205.                           shows file comments will be the default.
  1206.  
  1207.         - *** NOTE:  If you specify both /SD and /CO at startup, the LAST one
  1208.                      that you specified on the command line will take effect.
  1209.  
  1210.              /SF        - this will set the default screen format of the disk
  1211.                           summary report to be set to show the entries sorted
  1212.                           in descending order of free disk space, rather than
  1213.                           the default, which is sorted by volume id.  While in
  1214.                           the summary report screen, you can toggle between the
  1215.                           two sort methods by pressing the <Tab> key.
  1216.  
  1217.              /Rx        - this will allow you to set the initial location that
  1218.                           CATDISK will send a report.  This location can
  1219.                           still be changed from within the settings and toggles
  1220.                           menu.  x can be any of the following:
  1221.  
  1222.                           1 - Screen  2 - LPT1   3 - LPT2  4 - Disk File
  1223.                           5 - ASK (Prompt for location before each report)
  1224.  
  1225.              /Px        - Set printer output format to report type x, where x
  1226.                           is in the range (0-2).
  1227.  
  1228.                           x Value  Report Type
  1229.                           -------  -----------
  1230.  
  1231.                              0     Show regular file statistics
  1232.                              1     Show file comments
  1233.                              2     Show file statistics and comments
  1234.                                    (selecting this report style assumes that
  1235.                                    your printer is set to produce 132 column
  1236.                                    reports)
  1237.  
  1238.              /2         - Turn on CATDISK's two-sided printer reports to cut
  1239.                           down on paper consumption.  See the Settings &
  1240.                           Toggles menu for further details.
  1241.  
  1242.              /D:        - Catalog files from drive D: where D: is one of
  1243.                           [A - {last drive in your system}].
  1244.  
  1245.              /IP        - Initial Pause.  This parameter will cause CATDISK
  1246.                           to pause after it is loaded so that you may remove
  1247.                           the program disk (not needed during the session) and
  1248.                           insert the data disk. This option is only needed if
  1249.                           you are running on a single drive system.
  1250.  
  1251.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1252.  
  1253.                                       Page 18
  1254.  
  1255.  
  1256.  
  1257.              /ALIAS     - Adding this option to the command line will activate
  1258.                           the "ALIAS" feature whereby you will be able to
  1259.                           override the name under which a disk will be
  1260.                           cataloged.  Normally, CATDISK will catalog a disk
  1261.                           under the volume label.  This will enable you to
  1262.                           optionally catalog the disk under a different name
  1263.                           without changing the volume label on the disk being
  1264.                           cataloged.
  1265.  
  1266.  
  1267.              /NC        - Normally, when not instructed to read the directory
  1268.                           contents of ZIP or ARJ files, CATDISK will attempt to
  1269.                           read in the main comment from any ZIP or ARJ file
  1270.                           that it encounters.  Adding this option to the
  1271.                           command line  will allow you to turn this feature off
  1272.                           at startup.
  1273.  
  1274.                           Additionally, when CATDISK encounters a GIF file, it
  1275.                           will attempt to read in the resolution/color
  1276.                           information from it and place it in the comment
  1277.                           field.  This option will also disable this feature.
  1278.  
  1279.              /NCC       - normally, at startup, CATDISK will enable a feature
  1280.                           whereby any ZIP or ARJ files containing a main
  1281.                           comment that get expanded will have that main comment
  1282.                           inserted into the comment area of any file entry
  1283.                           extracted from that ZIP/ARJ file that does not
  1284.                           already have a comment.  By adding this option to the
  1285.                           command line, this feature will be turned off at
  1286.                           program startup.
  1287.  
  1288.         The slash "/" may be substituted by either a dash "-" or a space " ".
  1289.  
  1290.         Examples:  CATDISK /FGAMES/NS/AC/CO/P2/ALIAS/B:   or  CATDISK A:
  1291.  
  1292.         - entering CATDISK ? will bring up a help message indicating the above.
  1293.  
  1294.         NOTE:  You may also put the command line options in a DOS environment
  1295.         string using the DOS "SET" command.  This command (see examples below),
  1296.         may be placed in your AUTOEXEC.BAT file so that you will not need to
  1297.         remember which command line options to use to obtain your favorite
  1298.         setup, or for that matter, to type them!
  1299.  
  1300.         - example:  SET CATDISK=/FGAMES/NS/AC/CO/P2/ALIAS/B:
  1301.  
  1302.         When you start CATDISK under these circumstances, simply type "CATDISK"
  1303.         <Enter> and the above options will automatically be invoked.
  1304.  
  1305.         Any options entered on the command line will be added to those
  1306.         specified in the CATDISK environment variable.  This makes it possible
  1307.         to have a base set of options set in the DOS environment and have an
  1308.         optional set that you can specify at the time you run CATDISK.
  1309.  
  1310.         It is also possible to override some of the options as well (for
  1311.         example, the printed report format, the screen report format, the
  1312.         catalog file, and the catalog drive), as CATDISK will pay attention to
  1313.         the last option of a given type.
  1314.  
  1315.  
  1316.  
  1317.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1318.  
  1319.                                       Page 19
  1320.  
  1321.  
  1322.  
  1323.         For example, using the above environment example, entering the command
  1324.  
  1325.         CATDISK /A:/P1
  1326.  
  1327.         will cause CATDISK to set the catalog drive to A: (overrides the B:
  1328.         option), and the printer report format to show comments (format #1)
  1329.         instead of statistics and comments (format #2).
  1330.  
  1331.         Once CATDISK has been successfully started, a title screen will appear.
  1332.         Hit any key to ascend to the main menu.
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1384.  
  1385.                                       Page 20
  1386.  
  1387.  
  1388.  
  1389.                              3.  U S I N G   C A T D I S K
  1390.  
  1391.         USING THE MENUS
  1392.  
  1393.         The major options available from CATDISK such as the main functions
  1394.         that you see in the opening menu after the title page disappears can be
  1395.         selected in two different ways.
  1396.  
  1397.         The first, and easiest is just to hit the indicated key beside the
  1398.         desired option.
  1399.  
  1400.         In response to a requests from registered users, we have also
  1401.         implemented a "point and shoot" method of selecting items from a menu.
  1402.  
  1403.         Simply use the cursor keys to position the flashing arrows in the
  1404.         inverse box that indicates the keystroke required to activate the
  1405.         desired option and hit <Return> or <Enter>.  This will carry out the
  1406.         same function as if you had struck the key in the inverse box.
  1407.  
  1408.         One advantage that the second approach has to the first is that those
  1409.         of you who do not touch type numbers very well (or have a tendency to
  1410.         hit the key beside the one you are after) have another method to use to
  1411.         navigate through the menus of CATDISK.
  1412.  
  1413.         Another is that once you have activated a function such as cataloging a
  1414.         disk, you need only type <Return> to re-activate that function as
  1415.         CATDISK will remember the last option you activated (quite handy if you
  1416.         are cataloging multiple disks, as the <Return> key is larger than
  1417.         most... you aren't as apt to miss it).
  1418.  
  1419.         The menus in CATDISK currently consist of a main menu controlling the
  1420.         main functions of catalog maintenance, a settings & toggles menu
  1421.         containing functions that affect how CATDISK responds to certain
  1422.         situations, and a reports & inquiries menu from which all reports are
  1423.         accessed.
  1424.  
  1425.         Normally, to access the options available in the settings & toggles
  1426.         menu, you have to go to that menu of options from the main menu in
  1427.         order to change any of the settings.  Likewise, to generate any of
  1428.         CATDISK's reports, you have to go to the reports & inquiries menu and
  1429.         select the appropriate report from there.
  1430.  
  1431.         We have also provided shortcuts to both of these menus.
  1432.  
  1433.         To change any of the settings available in the settings and toggles
  1434.         menu directly from the either the main menu or the reports & inquiries
  1435.         menu, simply hold down the <Alt> key and press the number key (from the
  1436.         top row only, not the numeric keypad) or function key that you would
  1437.         normally hit if you were in the settings and toggles menu.  CATDISK
  1438.         will act on that keystroke as if you had selected that option directly
  1439.         from the settings and toggles appropriate menu.
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1450.  
  1451.                                       Page 21
  1452.  
  1453.  
  1454.  
  1455.         To generate a report available in the reports & inquiries menu directly
  1456.         from either the main menu or the settings & toggles menu, hold down the
  1457.         <Ctrl> key and hit the function key that corresponds to the number of
  1458.         the option in the reports & inquiries menu.  For example, you would
  1459.         need to hit <1> to generate a disk summary report.  If you are not in
  1460.         the reports & inquiries menu, you could hit <Ctrl>-<F1> to carry out
  1461.         the same function directly from the other menus.  Likewise, <Ctrl>-<F2>
  1462.         would correspond to report option <2> and so on.
  1463.  
  1464.         While it might make sense to use <Ctrl>-<number key> instead of
  1465.         <Ctrl>-<function key> for the reports, we have had to use the latter
  1466.         method due to limitations in the compiler used to compile CATDISK.  If
  1467.         a method becomes available in the future, we will incorporate the first
  1468.         method into CATDISK as well.
  1469.  
  1470.         You will probably find using the shortcuts preferable to using
  1471.         conventional means of accessing CATDISK's features and reports as you
  1472.         become more familiar with CATDISK and its operation.
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1516.  
  1517.                                       Page 22
  1518.  
  1519.  
  1520.  
  1521.         SELECTING A VOLUME NAME FROM A LIST
  1522.  
  1523.         Other than actually labeling a disk, there are three other locations in
  1524.         CATDISK where you will be prompted for a volume label: un-cataloging a
  1525.         disk; generating a report by volume id; and adding file comments by
  1526.         volume.  If you know what volume label is desired at the prompt, you
  1527.         may enter it verbatim.  Leaving it blank, however, will cause CATDISK
  1528.         to come up with a point-and-shoot list of all the volume names in the
  1529.         current catalog file.  When this list first appears, you will notice
  1530.         that the first volume is highlighted.  Selecting a volume from this
  1531.         list is merely a matter of moving the highlight bar to the desired
  1532.         volume and pressing <Enter>.
  1533.  
  1534.         The following options are available:
  1535.  
  1536.           <Cursor UP>   - move up one line in the list.  If you are already at
  1537.                           the top of a column, the highlight bar will move to
  1538.                           the bottom of the previous column if available.
  1539.  
  1540.           <Cursor DOWN> - move down one line in the list.  If you are already
  1541.                           at the bottom of a column, the highlight bar will
  1542.                           move to the top of the next column if available.
  1543.  
  1544.           <PgUp>        - move back 96 lines in the list.
  1545.  
  1546.           <PgDn>        - move ahead 96 lines in the list.
  1547.  
  1548.           <Home>        - move to the beginning of the list.
  1549.  
  1550.           <End>         - move to the end of the list.
  1551.  
  1552.           <Grey Plus>   - move forward in the list 1/15th of the total length
  1553.                           of the list (see the appendix regarding the SCROLL
  1554.                           BAR later in this manual).
  1555.  
  1556.           <Grey Minus>  - move back in the list 1/15th of the total length of
  1557.                           the list (see the appendix regarding the SCROLL BAR
  1558.                           later in this manual).
  1559.  
  1560.           <Enter>       - Select the highlighted volume for the prompt from the
  1561.                           previous screen.
  1562.  
  1563.           <Esc>         - return to the menu with no further action taken.
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1582.  
  1583.                                       Page 23
  1584.  
  1585.  
  1586.  
  1587.         OPTION 1 - SET DRIVE FOR CATALOGING
  1588.  
  1589.         This function allow you to set the drive from which the files to be
  1590.         cataloged will be read.  Simply select letter from (A - x) to select
  1591.         the drive with that DOS letter designation, where x is the last drive
  1592.         that CATDISK detected in your system configuration.  The change will be
  1593.         noted immediately in the status area at the top of the screen.
  1594.  
  1595.         *** NOTE:  If you are running with one floppy drive only and have
  1596.                    turned the caching option on from the configuration utility,
  1597.                    do not set this option to a drive other than the one on
  1598.                    which the catalog files reside (probably A:).  Failure to do
  1599.                    so could cause loss of data on your disks.
  1600.                    See the SAMPLE CONFIGURATIONS section covered earlier in
  1601.                    this section.  You have been warned!
  1602.  
  1603.         Users with a hard-disk, single floppy configuration, who are running
  1604.         CATDISK from the hard disk will NOT experience this problem and may
  1605.         proceed as normal.  It's ONLY if the same PHYSICAL drive is being used
  1606.         for the CATDISK work files AND the disk to be cataloged that the
  1607.         above precautions must be taken.
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1648.  
  1649.                                       Page 24
  1650.  
  1651.  
  1652.  
  1653.         OPTION 2 - SET CURRENT CATALOG FILE
  1654.  
  1655.         Although the catalog filename may be set upon starting up CATDISK, is
  1656.         may also be convenient to be able to change the current file from
  1657.         within a CATDISK session.  Select option #3 from the main menu, and you
  1658.         will be prompted for a new catalog file to use.  Any valid DOS filename
  1659.         will do.  Be sure to specify the NAME portion only; do not include the
  1660.         file extension portion.  If the name you specify is valid, it will then
  1661.         be used for all subsequent catalog updates and queries (This is
  1662.         reflected at the top of the screen).  If not, an error message will be
  1663.         issued and no change will be made to the current catalog file name.
  1664.  
  1665.         If the catalog file set that you specify does not exist, CATDISK will
  1666.         automatically create a new catalog for you.  Before doing so, however,
  1667.         CATDISK will indicate that the summary or catalog file does not exist
  1668.         and request your permission to create it before proceeding.  If you
  1669.         specified /NW on the command line, this warning will not appear -
  1670.         CATDISK will simply proceed to create any necessary files for the
  1671.         specified catalog set.
  1672.  
  1673.         If you don't enter anything for the catalog filename, a list of all
  1674.         current catalog files in the catalog directory will be displayed on the
  1675.         screen.  If the desired catalog is on a removable disk (i.e. floppy
  1676.         disks or removable hard drives), be sure and have that disk in the
  1677.         appropriate drive BEFORE you enter nothing to the prompt so the desired
  1678.         files will appear in the list.  This method can be handy when you are
  1679.         not sure of exactly what you called a particular catalog file.
  1680.  
  1681.         To select a file from the list, simply move the highlight bar around
  1682.         the list of filenames with the cursor keys so that it rests on the
  1683.         desired catalog file.  At this point, hit the <Enter> key, and that
  1684.         file will be selected as if you had typed it at the prompt.  Hitting
  1685.         <Esc> in this screen will abort the operation as if you had pressed
  1686.         <Esc> at the prompt.
  1687.  
  1688.         If you are switching to a catalog that already exists, and it will not
  1689.         fit into the configuration you defined in the configuration program
  1690.         (maximum disks/files per catalog), you will get an error message and
  1691.         the catalog file setting will be left unchanged.
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1714.  
  1715.                                       Page 25
  1716.  
  1717.  
  1718.  
  1719.         OPTION 3:  SETTINGS AND TOGGLES MENU
  1720.  
  1721.         The options available in this sub-menu will allow you to control the
  1722.         behavior of some of the features of CATDISK.  You can get to this menu
  1723.         by selecting option #2 from the main menu.
  1724.  
  1725.         The options available on this menu are:
  1726.  
  1727.  
  1728.         Sub-option 1 - Set Drive For Cataloging
  1729.         ---------------------------------------
  1730.  
  1731.         This is exactly the same for main menu option #1 and is included on the
  1732.         settings and toggles menu for convenience.
  1733.  
  1734.  
  1735.         Sub-option 2 - Pauses On/Off
  1736.         ----------------------------
  1737.  
  1738.         Under normal circumstances, CATDISK will pause at strategic places,
  1739.         either to allow you to view what has just happened (cataloging and
  1740.         un-cataloging), or to prompt you to insert a disk in drive X:
  1741.         (labeling or reading directories, etc).  If you turn this toggle off,
  1742.         CATDISK will only prompt you for a disk when absolutely necessary.  In
  1743.         addition, there will be no pause at the end of a catalog update; you
  1744.         will immediately be returned to the main menu, or to the comment entry
  1745.         screen if you have the AUTO COMMENT feature turned on.
  1746.  
  1747.  
  1748.         Sub-option 3 - Change Printer Report Type
  1749.         -----------------------------------------
  1750.  
  1751.         CATDISK currently supports three printer report styles, which are
  1752.         detailed here.  The particular report style that you desire may be set
  1753.  
  1754.         with this toggle, and will be reflected in the toggles portion of the
  1755.         menu screen.
  1756.  
  1757.         STATISTICS:  This is the default report style (unless overridden on the
  1758.                      command line), which is to show the path, filename, volume
  1759.                      id, ARCHIVE id, as well as the size, date, time and DOS
  1760.                      directory attributes of each file listed.
  1761.  
  1762.                      This report style corresponds to the command line option
  1763.                      /P0, and will fit on an 80 column printer.
  1764.  
  1765.           COMMENTS:  This report style will substitute file comments for the
  1766.                      size, date, time, and DOS directory attribute.
  1767.  
  1768.                      This report style corresponds to the command line option
  1769.                      /P1, and will fit on an 80 column printer.
  1770.  
  1771.           BOTH:      This report style will show all of the fields from the two
  1772.                      above reports.  Please note that it assumes that you
  1773.                      either have a 132 column printer, or an 80 column printer
  1774.                      set to compressed mode.  It corresponds to the command
  1775.                      line option /P2.
  1776.  
  1777.  
  1778.  
  1779.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1780.  
  1781.                                       Page 26
  1782.  
  1783.  
  1784.  
  1785.         Sub-option 4 - File Comments On The Fly
  1786.         ---------------------------------------
  1787.  
  1788.         If this toggle is turned OFF, CATDISK will proceed back to the main
  1789.         menu upon completion of the process of cataloging a disk.  If you wish
  1790.         to add comments for some/all of the files that you have just
  1791.         cataloged, you may turn this toggle ON.  When this is the case,
  1792.         CATDISK will catalog files in the normal manner, but upon completion,
  1793.         you will be taken to another screen that will allow you to scroll
  1794.         through the files you just cataloged and add/update the comments for
  1795.         each file shown.  See Option F1 - Add/Change File Comments for details
  1796.         on how this section of the program works.
  1797.  
  1798.  
  1799.         Sub-option 5 - Archive File Comment Copy
  1800.         ----------------------------------------
  1801.  
  1802.         If this feature is turned on, CATDISK will take special action when
  1803.         expanding ZIP and ARJ files.  If a main ZIP/ARJ file comment is found,
  1804.         any file entries extracted that do not have comments will have the main
  1805.         ZIP/ARJ file comment entry inserted instead.  The presence of a "C"
  1806.         beside the Auto Comments setting in the status information at the top
  1807.         of the screen indicates that this feature is turned on.
  1808.  
  1809.         Sub-option 6 - Extract 4DOS/NDOS Comments
  1810.         -----------------------------------------
  1811.  
  1812.         This setting controls whether or not CATDISK will process directory
  1813.         comments created by JP Software's 4DOS or Symantec Software's Norton
  1814.         DOS (NDOS).  If on, CATDISK, during a cataloging operation, will look
  1815.         for a hidden file in each subdirectory called "DESCRIPT.ION", which
  1816.         contains the text for these comments.  Where applicable, these comments
  1817.         will be included in your catalog file automatically.  If off, CATDISK
  1818.         will ignore these comments.  The presence of a "4" beside the Auto
  1819.         Comments setting in the status information at the top of the screen
  1820.         indicates that this feature is turned on.
  1821.  
  1822.         Although not tested, Norton DOS (NDOS) is largely based on JP
  1823.         Software's 4DOS program, and should work in a similar manner to that
  1824.         product.
  1825.  
  1826.  
  1827.         Sub-option 7 - Set Current Report Destination
  1828.         ----------------------------------------------
  1829.  
  1830.         Selecting this option will affect the report destination and whether or
  1831.         not CATDISK will ask you where the report should go.  Each time you
  1832.         select option 1, CATDISK will run through a sequence of five possible
  1833.         locations (SCRN (Screen), LPT1, LPT2, Disk, or ASK).
  1834.  
  1835.         Selecting one of the first four will cause CATDISK to immediately
  1836.         generate a report to the selected destination IMMEDIATELY upon
  1837.         selecting it.  You will not be prompted any further, unless you have
  1838.         selected DISK, in which case, you will be asked for a filename in which
  1839.         to place the report.
  1840.  
  1841.         If you select ASK, CATDISK will prompt you for a report location (one
  1842.         of the first four in the list) each time you ask it to generate a
  1843.         report.
  1844.  
  1845.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1846.  
  1847.                                       Page 27
  1848.  
  1849.  
  1850.  
  1851.         I usually leave this setting set to SCREEN as, most of the time, I
  1852.         browse through my catalog files on the screen.  You, however, may find
  1853.         it handy to set this to ASK, especially if you jump to report locations
  1854.         frequently.  If this is the case, you may, if you haven't already, add
  1855.         the command line option /ASK to your current list of options.  This
  1856.         will override the default location of SCREEN at startup, negating the
  1857.         need to set it manually each time you start CATDISK.
  1858.  
  1859.  
  1860.         Sub-option 8 - Activating/Deactivating Two Sided Printer Reports
  1861.         ----------------------------------------------------------------
  1862.  
  1863.         Normally, CATDISK will print its hardcopy reports in a continuous
  1864.         stream to the printer.  By turning this feature on, CATDISK will print
  1865.         your reports in a format such that the odd numbered pages will be
  1866.         printed first.  CATDISK will then pause and ask you to re-insert the
  1867.         paper in your printer so that the even numbered pages will print on the
  1868.         back side of the odd numbered pages.  This will cut paper consumption
  1869.         on your reports in half.
  1870.  
  1871.         You will know when this feature is activated when you see a "/2" beside
  1872.         the report location in the information at the top of the screen.
  1873.  
  1874.         IMPORTANT NOTE:  Re-inserting paper previously printed on back into
  1875.                          some types of laser printers can cause damage to the
  1876.                          internal mechanisms of those printers.  Consult your
  1877.                          printer manual or check with the manufacturer before
  1878.                          using this option with your laser printer.
  1879.  
  1880.  
  1881.         Sub-option 9 - ARCHIVE Extract Setting
  1882.         --------------------------------------
  1883.  
  1884.         Although this setting is permanently set from the CDISKCFG utility, it
  1885.         is sometimes be convenient to be able to change it during a CATDISK
  1886.         session.  Selecting option 2 will run the Auto ARCHIVE Extract setting
  1887.         through three possibilities, OFF, ON, or QUERY.  The current setting is
  1888.         shown near the top of the screen in the status area.
  1889.  
  1890.         If this feature is turned OFF, any file searches through the catalog,
  1891.         with the exception of OPTION #0 - Show All Files, will NOT show any
  1892.         files that reside in an archive file.  The archive file's presence will
  1893.         still be shown in the listing.
  1894.  
  1895.         If this feature is turned ON, CATDISK will extract the archive
  1896.         directory of any archive it encounters in its search.
  1897.  
  1898.         If it is set to QUERY, CATDISK will prompt you as to whether it should
  1899.         extract the archive directory of any archive that it encounters in its
  1900.         search before proceeding to do so.  Reports generated will act as if
  1901.         the feature is turned ON.
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1912.  
  1913.                                       Page 28
  1914.  
  1915.  
  1916.  
  1917.         Sub-option 0 - Comments When Arcs Not Extracted
  1918.         -----------------------------------------------
  1919.  
  1920.         In the course of its normal operation, CATDISK, when not extracting the
  1921.         directory information from ZIP or ARJ files, will search each one it
  1922.         encounters for the comment of the ZIP/ARJ file itself.  Under some
  1923.         circumstances, such as those where your particular collection of
  1924.         ZIP/ARJ files do not contain comments, or where the vast majority of
  1925.         them contain BBS advertisements (not really what they were intended
  1926.         for), this search can be both time consuming and meaningless.  This
  1927.         toggle will turn this feature on or off.  The presence of a "C" beside
  1928.         the Archive Extract setting in the status information at the top of the
  1929.         screen indicates that this feature is turned on.
  1930.  
  1931.         Although not related to ZIP/ARJ files, this feature will also control
  1932.         whether or not the graphic resolution and color information will be
  1933.         extracted from a GIF file to be included as the default comment for
  1934.         that particular file.
  1935.  
  1936.  
  1937.         Sub-option F1 - Aliases On/Off
  1938.         -----------------------------
  1939.  
  1940.         Activating this option will enable you to override the name under which
  1941.         a disk will be cataloged.  Normally, CATDISK will catalog a disk under
  1942.         the volume label.  This will allow you to optionally catalog the disk
  1943.         under a different name without changing the volume label on the disk
  1944.         being cataloged.  Keep in mind that if you re-catalog the disk at a
  1945.         later time, you must remember the new name that you gave to the disk in
  1946.         your catalog, otherwise, duplication will occur in your catalog.
  1947.  
  1948.  
  1949.         Sub-option <Esc> - Return To Main Menu
  1950.         --------------------------------------
  1951.  
  1952.         Exactly what it says.
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  1978.  
  1979.                                       Page 29
  1980.  
  1981.  
  1982.  
  1983.         OPTION 4:  LABELING A DISK
  1984.  
  1985.         Selection of option #4 on the main menu will allow the VOLUME LABEL of
  1986.         a disk to be set or changed.  Upon selection, CATDISK will attempt to
  1987.         read the current label of the disk.  If none is present, you will be
  1988.         notified of this, and will be given the opportunity to create a volume
  1989.         label for that disk.  See the DOS manual on volume labels for more
  1990.         information.  If a label already exists on the disk, its name will be
  1991.         shown as a reminder, and you will be given an opportunity to change the
  1992.         label name.  Just enter the new label name and hit <CR>.
  1993.  
  1994.         If the label name was valid, the change will be made, otherwise, an
  1995.         error message indicating such will be issued and you will return to the
  1996.         main menu.
  1997.  
  1998.         If you do not wish to enter or change the disk label, simply hit <ESC>
  1999.         at the volume label prompt and you will immediately return to the main
  2000.         menu with no changed made to the disk label.
  2001.  
  2002.         When the volume label has been successfully changed or created, CATDISK
  2003.         will check to see if the old label, if any was present, exists in the
  2004.         current catalog file.  If so, you will be given an opportunity to have
  2005.         CATDISK automatically change the old volume id references to the newly
  2006.         entered one.  If the disk that you re-labeled is one that actually is
  2007.         in the catalog, answer <Y>es to the prompt.  CATDISK will take care of
  2008.         the rest.  This feature can be a great time saver, as it eliminates the
  2009.         need to uncatalog the disk under the old volume id, and re-catalog it
  2010.         under the new name.
  2011.  
  2012.         If the disk is not in the catalog, answer <N>o to the prompt. Answering
  2013.         <Y>es under these circumstances will not damage the catalog file, but
  2014.         will cause confusion as to what disk the altered catalog records reside
  2015.         on.
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2044.  
  2045.                                       Page 30
  2046.  
  2047.  
  2048.  
  2049.         OPTION 5:  CATALOGING A DISK
  2050.  
  2051.         This selection will initiate cataloging of the files on the selected
  2052.         catalog disk as shown in the status area at the top of the screen.  The
  2053.         volume label will be read, and if it doesn't exist, you will be given
  2054.         an opportunity to enter a volume label for the disk.  If you hit <ESC>
  2055.         at the label prompt, the operation will be aborted and you will be
  2056.         returned to the main menu without cataloging your disk.  After entering
  2057.         the label name for that disk, you will be asked if you wish to write
  2058.         that label to disk.  If you answer <Y>es, the disk will be labeled and
  2059.         cataloging will continue.  If you answer <N>o, the label will not be
  2060.         written, but the disk will be cataloged under the name that you gave
  2061.         it.  This will allow easy cataloging of write-protected disks.
  2062.  
  2063.         Please note that volume labels created by Peter Norton's "Volabel"
  2064.         utility may contain lower case characters.  CATDISK will convert the
  2065.         labels to upper case before adding them to the catalog.  This will
  2066.         enable you to manipulate and uncatalog any of these disks.  The
  2067.         physical volume label on the disk will be left unchanged.
  2068.  
  2069.         There are volume label utilities on the market that allow the entry of
  2070.         illegal characters into the volume label.  CATDISK will change these
  2071.         offending characters into spaces when it encounters them.  This will
  2072.         not affect the physical label on the disk, but rather the way CATDISK
  2073.         stores them in its catalog files.
  2074.  
  2075.         If the label on the disk to be cataloged already exists in the
  2076.         catalog, you will be notified of this situation, and will be given an
  2077.         opportunity to abort the operation.  This feature has been added as a
  2078.         safeguard against a situation where two disks of the same volume id may
  2079.         be overriding each other and clobbering the catalog contents of the
  2080.         other disk.  If you specified the "/NW" option on at startup, this
  2081.         warning will not be issued.
  2082.  
  2083.         If you specified /ALIAS in your startup options, a screen will appear
  2084.         showing you what the current volume label is on the disk you are about
  2085.         to catalog.  A prompt will appear below this asking you for a name
  2086.         under which you would like the disk to be cataloged.  The current
  2087.         volume label will be displayed in this area, and you will be allowed to
  2088.         change it before the cataloging process takes place.  This can be very
  2089.         handy in certain situations such as vendor disks that insist that the
  2090.         volume label remain unchanged, as the software uses the volume label to
  2091.         identify the disk.  The volume label on the disk may not mean anything
  2092.         to you, and  using an alias may be desirable in this case.
  2093.  
  2094.         As flexible as the ability to catalog under an alias can be, there are
  2095.         a couple of drawbacks that should be considered before you decide to
  2096.         make the name in the catalog different from the volume label on the
  2097.         disk.  Firstly, if you go to re-catalog the disk at a later time and
  2098.         don't provide exactly the same alias that was used initially, you can
  2099.         wind up with duplicate entries in the catalog file, as CATDISK
  2100.         currently has no way of knowing that the disk has already been
  2101.         cataloged.  Secondly, if at a later date, you use option #3 in CATDISK
  2102.         to change the volume label on a disk that has already been cataloged,
  2103.         CATDISK will have no way of knowing that it should give you the
  2104.         opportunity to change the entries in the catalog to reflect the new
  2105.         volume label, as the entries are not cataloged under the old volume
  2106.         label.
  2107.  
  2108.  
  2109.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2110.  
  2111.                                       Page 31
  2112.  
  2113.  
  2114.  
  2115.         The best advice would be that if you never intend to re-catalog a disk
  2116.         in the future, then it would be ok to use an alias, otherwise, it's
  2117.         best to stick with a meaningful volume label.
  2118.  
  2119.         Once the name of the disk has been established for cataloging purposes,
  2120.         the directory and any archive or library entries (if the ARCHIVE auto
  2121.         extract feature option is turned on - it is by default) will be read
  2122.         (if the ARCHIVE auto extract is set to QUERY, you will be asked for
  2123.         verification before a given archive or Library will be read).  This
  2124.         process will be repeated for each sub-directory on the disk as well.
  2125.         All existing levels of sub-directories will be searched.
  2126.  
  2127.         If the archive comment extract feature is turned on (see sub-option #0
  2128.         in the settings & toggles menu), CATDISK will extract the graphic
  2129.         resolution and color information of any GIF files that it encounters
  2130.         during its operation and place this information in the comment field
  2131.         (if it is a new file, or an existing entry in the catalog file that is
  2132.         blank) as the default comment.  For example, a picture contained in a
  2133.         GIF file that has a resolution of 640 by 480 pixels and contains 256
  2134.         colors will appear as "640x480x256".
  2135.  
  2136.         If CATDISK encounters a ZIP, ARJ, ZOO or DWC file, any comments that
  2137.         may be stored in that file will be read and included in the catalog
  2138.         file, if that archive is expanded.  If the operation is a re-cataloging
  2139.         operation and any extracted filenames already exist in the catalog file
  2140.         with comments attached, the comment from the archive file will be
  2141.         ignored.
  2142.  
  2143.         ZIP and ARJ files, in addition to supporting comment entries for each
  2144.         file contained, can also have a main comment for the ZIP/ARJ file
  2145.         itself.  When CATDISK reads ZIP/ARJ files and finds a main comment, it
  2146.         will insert that main comment in the catalog file for any entries in
  2147.         the ZIP/ARJ file that do not already have comments.  This feature of
  2148.         copying the main ZIP/ARJ file comment can be turned on and off via the
  2149.         settings and toggles menu as desired.
  2150.  
  2151.         If the 4DOS/NDOS comment extract feature is turned on (it is by
  2152.         default), CATDISK will attempt to find a file (that may be hidden) in
  2153.         each subdirectoy called "DESCRIPT.ION".  This file will be present if
  2154.         you have used the 4DOS/NDOS "Describe" command to add file descriptions
  2155.         to your directory entries.  If CATDISK is able to locate this file, it
  2156.         will automatically add any matching comments to your catalog entries
  2157.         where appropriate.
  2158.  
  2159.         Upon completion of this, the catalog summary file and master catalog
  2160.         will be updated to reflect the current directory/directories of the
  2161.         disk.  If any files have been added, they will be added to the catalog;
  2162.         if any files have been changed, they will be updated;  if any files
  2163.         have been deleted, they will be removed from the catalog.
  2164.  
  2165.         If, while reading the disk, CATDISK cannot find any files there, it
  2166.         will ask you if you would like to add that disk to the catalog anyway.
  2167.         Why would you want to add such a disk to the catalog?  The answer to
  2168.         this question can best be explained by an example.
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2176.  
  2177.                                       Page 32
  2178.  
  2179.  
  2180.  
  2181.         You're maintaining a collection of disks for a computer users group.
  2182.         One day, you decide to clean up your collection, eliminating any
  2183.         duplicates that may have crept into the collection.  While you're
  2184.         eliminating the duplicates, several of the disks in the sequence become
  2185.         completely empty.  In this case, it is desirable to have the disk
  2186.         showing in the summary file as having its capacity completely available
  2187.         to accept new files.  Additionally, all the files that were eliminated
  2188.         from that disk will be un-cataloged by CATDISK through its normal
  2189.         function.  If the disk has never been cataloged before, this method
  2190.         represents a way to "pre-allocate" the disks to the collection and
  2191.         initialize their entries in the catalog file.
  2192.  
  2193.         If you would like to have the blank disk included in the catalog,
  2194.         answer YES to the prompt, otherwise, answer NO.  If you elect not to
  2195.         include the disk in the catalog file, and it has already been cataloged
  2196.         before, it would be advisable to remove that volume listing from the
  2197.         catalog file using option #5.
  2198.  
  2199.         Keep in mind, that deletion of an archive file will cause any files
  2200.         existing within that archive file to be uncataloged.  Also, turning the
  2201.         Auto Archive Extraction feature OFF, or answering <No> to a Extract
  2202.         Archive prompt to a cataloged Archive will cause any files in an
  2203.         Archive file on that disk to be uncataloged as well.
  2204.  
  2205.         Should the disk become full when the cataloging process is underway,
  2206.         the process will be aborted with an error message.  The old catalog
  2207.         file will remain intact (i.e. no changes made), but the summary file
  2208.         will reflect either the presence of the new disk, or the current status
  2209.         of that disk if it already existed in the catalog.  This means that the
  2210.         catalog file will not be accurate as to what's on the disk that you
  2211.         attempted to catalog.   If this error is encountered, you should either
  2212.         try to free up some space on disk on which the catalog file exists, or
  2213.         move the .DTA and .SUM files to another disk (see CONFIGURING CATDISK
  2214.         for details on how to access catalog files on other drives and
  2215.         directories) and retry the operation.
  2216.  
  2217.         The cataloging  operation is completely automatic and does not require
  2218.         any further input from the operator once started, unless, of course,
  2219.         the ARCHIVE extract state is set to QUERY.
  2220.  
  2221.         If you have turned on the auto-comment feature either from the
  2222.         command line or from the toggles menu, you will be taken to a section
  2223.         of the program that will allow you to add/update file comments for the
  2224.         group of files that CATDISK just added to or updated in your catalog.
  2225.  
  2226.         See the discussion on "OPTION 7 - CHANGE COMMENTS BY VOLUME ID" for a
  2227.         discussion on how the comment editor works.
  2228.  
  2229.         Please keep in mind that CATDISK has an internal limitation of being
  2230.         able to read in only the first 5000 files of the disk being cataloged,
  2231.         if available memory permits.
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2242.  
  2243.                                       Page 33
  2244.  
  2245.  
  2246.  
  2247.         OPTION F1:  UNCATALOGING A DISK
  2248.  
  2249.         There may be times when you will wish to remove a disk's files from the
  2250.         catalog.  Select option <F1> from the main menu, and you will be asked
  2251.         to enter the VOLUME NAME of the disk to be uncataloged.  Enter it and
  2252.         hit <Enter>.  If the volume label doesn't exist in the catalog, then
  2253.         you will be notified and returned to the main menu.
  2254.  
  2255.         Optionally, you can leave the volume ID blank at the prompt.  CATDISK
  2256.         will bring up a point-and-shoot menu from which you can select a volume
  2257.         id from those in your current catalog.  See the section entitled
  2258.         "Selecting A Volume Name From A List" previously discussed in this user
  2259.         manual.
  2260.  
  2261.         If the volume label is found in the catalog, its entry will be deleted
  2262.         along with all the file names under it.
  2263.  
  2264.         If you do not wish to carry out this operation, hit <Esc> at the volume
  2265.         label prompt and no action will be taken.
  2266.  
  2267.         Should the disk become full during the catalog update process, the
  2268.         process will be aborted with an error message, and the old catalog file
  2269.         will remain intact.  Typically, this error should not occur, unless you
  2270.         have added more files to the disk, or another program has used up more
  2271.         disk space (such as a database expanding a file).  Should this error
  2272.         occur, the summary file will no longer contain a reference to the
  2273.         diskette that was uncataloged, but the catalog file will still contain
  2274.         references to that diskette.
  2275.  
  2276.         Should this be the case, you should either free up some space on the
  2277.         disk, or copy the .SUM and .DTA files to another disk (see CONFIGURING
  2278.         CATDISK for details on accessing catalog files on other drives and
  2279.         directories), catalog the diskette in question, and uncatalog it again.
  2280.         This will remove any references to that disk from the catalog file.
  2281.  
  2282.         If you do not have access to that disk any more (you may have erased
  2283.         it), simply take a blank diskette, add one file to it, and label it the
  2284.         same as the diskette you wish to uncatalog.  Carry out the above
  2285.         procedure, and you will obtain the same results.
  2286.  
  2287.         In practice, this should not happen, as you would have needed
  2288.         sufficient disk space to create the catalog file in the first place.
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2308.  
  2309.                                       Page 34
  2310.  
  2311.  
  2312.  
  2313.         OPTION 6:  CHANGE COMMENTS BY VOLUME ID
  2314.  
  2315.         There are two basic places from where CATDISK's comment editor may be
  2316.         invoked:  1) At the end of a cataloging operation when AUTOCOMMENTS is
  2317.         turned on; and 2) As a result of option #6, option #7, option #8 or
  2318.         option #9 from the main menu.
  2319.  
  2320.         The actual functionality of the comment editor will be discussed later
  2321.         on in this section.
  2322.  
  2323.         If you select this option #7 from the main menu, you will be asked to
  2324.         specify a disk volume. Upon entry of such, CATDISK will go through the
  2325.         catalog and bring a group of files into the comment editor that
  2326.         currently reside on that disk volume.
  2327.  
  2328.         Optionally, you can leave the volume ID blank at the prompt.  CATDISK
  2329.         will bring up a point-and-shoot menu from which you can select a volume
  2330.         id from those in your current catalog.  See the section entitled
  2331.         "Selecting A Volume Name From A List" previously discussed in this user
  2332.         manual.
  2333.  
  2334.         Here's how the comment editor works:
  2335.  
  2336.         Once CATDISK has found a group of files for commenting, they will
  2337.         appear on the screen in a format similar to the "COMMENT" screen output
  2338.         format, the main difference being that one of the comments (or blanks)
  2339.         are highlighted in an inverse field.
  2340.  
  2341.         To change a comment, simply move the highlight to the file that you
  2342.         wish to comment, and start typing.  When you are done, hit the <Return>
  2343.         key.
  2344.  
  2345.         Other editing keys are as follows:
  2346.  
  2347.           <Left Arrow>  - move cursor one character to the left.
  2348.           <Right Arrow> - move cursor one key to the right.
  2349.           <Home>        - move cursor to the beginning of the line
  2350.                           (once you have started typing).
  2351.           <End>         - move cursor to the end of the line
  2352.                           (once you have started typing).
  2353.           <Ctrl>-<End>  - erase from the cursor to the end of the line.
  2354.           <Del>         - delete the character at the cursor and shift the
  2355.                           characters on the right to the left.
  2356.           <Backspace>   - delete the character before the cursor and shift the
  2357.                           characters on the right to the left.
  2358.           <Ins>         - toggle insert/overstrike mode
  2359.                         - in insert mode the cursor will be slightly fatter
  2360.                           than the one in overstrike mode.
  2361.  
  2362.           <Esc>         - cancel the changes and restore the line to its
  2363.                           original contents.
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2374.  
  2375.                                       Page 35
  2376.  
  2377.  
  2378.  
  2379.         In some (and probably most) cases, the file list will be too large to
  2380.         fit on the screen.  The list may be browsed through by using the keys
  2381.         on the cursor keypad.  Their functions:
  2382.  
  2383.         <UP> & <DOWN>   will move the highlight bar up or down one file.  If
  2384.                         you at a screen margin, and there are still more
  2385.                         files to be browsed, the listing on the screen will
  2386.                         scroll in the appropriate direction.  If you can't move
  2387.                         any more, you will hear a short beep.
  2388.  
  2389.         <PgUp> & <PgDn> will move you 15 files forward or backward in the list
  2390.                         If you can't move any more, you will hear a short beep.
  2391.  
  2392.         <Home> & <End>  will move you to the beginning or end of the group of
  2393.                         files respectively.
  2394.  
  2395.         <F8>            will repeat the comment on which the highlight bar
  2396.                         currently rests to all entries in the list of files.
  2397.                         If the currently highlighted comment is blank, a short
  2398.                         beep will sound and no further action will be taken.
  2399.                         This option provides a quick way to enter a single
  2400.                         comment for all files on an entire disk... just enter
  2401.                         the first one, re-highlight it and press <F8> to
  2402.                         duplicate it to each entry for that disk.  This option
  2403.                         is not shown at the bottom of the screen due to lack of
  2404.                         room on the instruction line.
  2405.  
  2406.         <F9>            will repeat the Last Entered Comment.  This is handy if
  2407.                         you want to repeat a single comment at different places
  2408.                         in the list where <F10> (see below) won't suffice, as
  2409.                         the comment desired is not directly above the current
  2410.                         position.  If no comment was previously entered, or
  2411.                         the last entered comment was blank, no action will be
  2412.                         taken.
  2413.  
  2414.         <F10>           will "Ditto":  Pressing this key will copy the comment
  2415.                         from the entry above.  It is handy if you want to copy
  2416.                         a comment down a consecutive list of files, or one that
  2417.                         was already previously entered at an earlier time, if
  2418.                         it is directly above the current position.  If the
  2419.                         comment above is blank, or you are at the top of the
  2420.                         list, no action will be taken.
  2421.  
  2422.         <Grey Plus>     move down through the list 1/15th of the total length
  2423.                         of the list (see the appendix regarding the SCROLL BAR
  2424.                         later in this manual).
  2425.  
  2426.         <Grey Minus>    move up through the list 1/15th of the total length of
  2427.                         the list (see the appendix regarding the SCROLL BAR
  2428.                         later in this manual).
  2429.  
  2430.         <Tab>           This will toggle the information shown on the left of
  2431.                         the comment area between showing the subdirectory,
  2432.                         archive and volume information and showing the archive,
  2433.                         file size and date information.  This option is not
  2434.                         shown at the bottom of the screen due to lack of room
  2435.                         on the instruction line.
  2436.  
  2437.         <Esc>           Return to the main menu when you are done.
  2438.  
  2439.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2440.  
  2441.                                       Page 36
  2442.  
  2443.  
  2444.  
  2445.         OPTION 7:  ADD/UPDATE COMMENTS BY FILESPEC
  2446.  
  2447.         If you select option #7 from the main menu, you will be asked for a
  2448.         filespec on which to base the search.  This filespec can be a based on
  2449.         CATDISK's enhancements to the DOS wildcard specifications (See option
  2450.         #0 (Reports And Inquiries), sub-option #4 (Show Files By Filespec) for
  2451.         a discussion of wildcard searching.  Once the catalog records are
  2452.         loaded into the comment editor according to your criteria, the same
  2453.         options that apply to option #6 apply here (see it for details).
  2454.  
  2455.  
  2456.         OPTION 8:  SEARCH/EDIT FILES BY COMMENT
  2457.  
  2458.         If you select option #8 from the main menu, CATDISK will ask you for a
  2459.         comment spec on which to base the search.  Simply enter the sub-string
  2460.         for which you wish to search.  A discussion on how CATDISK matches
  2461.         comments can be found in the discussion on option #0 (Reports And
  2462.         Inquiries), sub-option #5 (Files by comment).  Once the catalog records
  2463.         are loaded into the comment editor according to your criteria, the same
  2464.         options that apply to option #6 apply here (see it for details).
  2465.  
  2466.  
  2467.         OPTION 9:  IMPORT COMMENTS FROM A TEXT FILE
  2468.  
  2469.         Option #9, "Import Comments From A Text File", will allow you to bring
  2470.         in file comments from an external source, be it a BBS listing that
  2471.         you've either downloaded or captured with your communications package,
  2472.         or any file that contains plain text.  This file can contain anything:
  2473.         filesizes, dates, times, etc.  The only limitations are that the file
  2474.         contain no tabs, and that each line be no longer than 255 characters.
  2475.  
  2476.         Many utilities such as Norton's fileinfo (FI) utility can re-direct
  2477.         their output to a text file simply by appending ">TEXTFILE" (without
  2478.         the quotes) to the command.  Using Norton's FI utility as an example,
  2479.         you could use "FI A: /C/L >TEXTFILE" to produce a file called TEXTFILE
  2480.         that would contain comments for many of the files on a floppy disk.
  2481.         Please refer to your Norton Utilities manual for details on how to
  2482.         maintain those comments with FI.
  2483.  
  2484.         Once you select option #9, a screen containing the controlling settings
  2485.         for the expected text file will appear.  These settings can be stored
  2486.         in a setup file (profile) for later retrieval.  To avoid disk clutter,
  2487.         profiles are stored in the same directory as your catalog files.  This
  2488.         eliminates the need for having to remember the settings for, say, the
  2489.         file dump from Norton's FI as described earlier on.  You can enter the
  2490.         settings once, save them to a profile and be able to recall them later
  2491.         on.  The first item on the screen indicates what file the current
  2492.         settings came from.
  2493.  
  2494.         The second item is the filename of the textfile from which the comments
  2495.         will be read.  The next 8 settings will depend on the characteristics
  2496.         of the file being read.  The pre-filled numbers assume that you are
  2497.         reading comments from CATDISK's own report printed to disk showing both
  2498.         statistics and comments.
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2506.  
  2507.                                       Page 37
  2508.  
  2509.  
  2510.  
  2511.         The first setting is the beginning and ending character positions of
  2512.         the filename as it appears on each line.  These settings are critical
  2513.         for CATDISK to be able to identify where to put each comment, and must
  2514.         contain a value greater than zero.
  2515.  
  2516.         The second setting is the beginning and ending character positions of
  2517.         the subdirectory, if it exists in the text file.  If the text file
  2518.         contains the subdirectory in which each file resides, you may include
  2519.         it with these settings, or if either the file does not contain
  2520.         subdirectory information, or you do not wish to use it, you may set the
  2521.         beginning and ending positions to zero.  CATDISK will then ignore them.
  2522.  
  2523.         The third setting is the beginning and ending character positions of
  2524.         the volume id, if it exists in the text file.  If the text file
  2525.         contains the volume id for the disk on which each file resides, you may
  2526.         include it with these settings, or if either the file does not contain
  2527.         this information, or you do not wish to use it, you may set the
  2528.         beginning and ending positions to zero.  CATDISK will then ignore them.
  2529.         Finally, the last setting is the starting and ending character
  2530.         positions of the file comment.  These values must also be set to
  2531.         something that is greater than zero, as CATDISK needs a comment to
  2532.         insert for each file that it finds in your catalog file.
  2533.  
  2534.         The easiest way to determine the appropriate settings for the text file
  2535.         you will be importing is to first load it into your favorite text
  2536.         editor.  Place the cursor on the beginning and ending characters of the
  2537.         various items discussed above, and note what column the editor
  2538.         indicates that the current cursor position is.  These will be the
  2539.         values that you will fill in to the control screen.
  2540.  
  2541.         Here are a few important notes regarding the text file.  There is
  2542.         really no need to edit blank lines and headings out of the file before
  2543.         processing, as the chances of CATDISK matching a filename, subdirectory
  2544.         and volume id found in the appropriate character positions in a heading
  2545.         with a file entry in the catalog file are quite slim.  It is important
  2546.         that each data line (not the headings) in the file be structured the
  2547.         same way (i.e. all the columns line up as in a report).  If this is not
  2548.         the case, chaos in the comments fields in the affected files will
  2549.         result.  Lastly, CATDISK has an internal limitation of being able to
  2550.         read in only the first 32,767 non-blank lines in the file.  The rest
  2551.         will be ignored.
  2552.  
  2553.         All this said, changing the settings is a matter of using the <Up> and
  2554.         <Down> arrow keys to highlight the desired setting, typing the new
  2555.         information for that setting and hitting <Enter>.  Pressing <Esc> when
  2556.         not editing a setting will return you to the menu with no further
  2557.         action taken.
  2558.  
  2559.         Retrieving and saving profiles is a simple matter of typing in the
  2560.         desired filename on the first line of the screen.  When you do so, you
  2561.         will be asked if you would like to read settings in from that file, or
  2562.         save the current ones to that file.  If you attempt to read in a
  2563.         profile that does not exist, you will be given an error message and no
  2564.         settings will be changed.  If, however, the file does exist and either
  2565.         a disk read error occurs or it is determined that the file is not a
  2566.         valid profile, the default settings (that which were supplied the first
  2567.         time you used this feature) will be brought in.
  2568.  
  2569.  
  2570.  
  2571.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2572.  
  2573.                                       Page 38
  2574.  
  2575.  
  2576.  
  2577.         If you wish to save the current settings to disk, CATDISK will first
  2578.         check to see if the file already exists.  If so, you will be given a
  2579.         warning to enable you to abandon the operation before you accidentally
  2580.         over-write a valuable program or data file.
  2581.  
  2582.         Any changes made in the settings during an import session will
  2583.         automatically be saved to the current profile on exit from the settings
  2584.         modification screen (via <Esc> or <F10>).  Again, if the file named in
  2585.         the first line exists, you will be given an overwrite warning in case
  2586.         you don't actually want to overwrite the current saved settings with
  2587.         the new ones (i.e. the import operation is a one-time shot in this
  2588.         case).
  2589.  
  2590.         Once you have all the desired settings ready, press <F10> to initiate
  2591.         the insertion of comments in the catalog file.  Here's what CATDISK
  2592.         does to accomplish this.  First, it will read and sort all the entries
  2593.         in the text file.  If CATDISK cannot find the text file, if there is an
  2594.         error in reading the text file, or there is an error in sorting the
  2595.         entries, the process will be aborted.  If the sort is successful,
  2596.         CATDISK will scan your current catalog file for matching entries from
  2597.         the text file.
  2598.  
  2599.         For each match that CATDISK finds, it will determine if the comment
  2600.         field from the catalog file is blank (CATDISK will not overwrite
  2601.         previously entered comments for the sake of integrity).  If so, the
  2602.         first 30 characters of the comment from the text file will be inserted
  2603.         into the comment field for that file in the catalog file.
  2604.  
  2605.         Once this process has completed, a list of the modified entries will be
  2606.         brought into the comment editor for "massaging" if you would like to
  2607.         clean up any entries.  It is highly recommended that you at least go
  2608.         through the list just to make sure that everything went ok.  Below is a
  2609.         discussion on how you can view and change the comments of the modified
  2610.         entries.
  2611.         
  2612.         
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2638.  
  2639.                                       Page 39
  2640.  
  2641.  
  2642.  
  2643.         OPTION 0: REPORTS & INQUIRIES MENU
  2644.  
  2645.         This menu outlines the complete range of screen or printer-based
  2646.         reports that CATDISK is capable of generating.  Selection of an option
  2647.         from this menu is by conventional means as outlined in the section
  2648.         "Using The Menus" earlier on in this user manual.
  2649.  
  2650.  
  2651.         Screen-based reports
  2652.         --------------------
  2653.  
  2654.         When viewing a report on your screen, there will be several options
  2655.         available to you.  The following are available in ALL screen based
  2656.         reports:
  2657.  
  2658.           <Cursor UP>   - move up one line in the report.  The screen contents
  2659.                           will scroll down to make room for the new line
  2660.                           appearing at the top.
  2661.  
  2662.           <Cursor DOWN> - move down one line in the report.  The screen
  2663.                           contents will scroll up to make room for the new line
  2664.                           appearing at the bottom.
  2665.  
  2666.           <PgUp>        - move up one page (15 lines) in the report.
  2667.  
  2668.           <PgDn>        - move down one page (15 lines) in the report.
  2669.  
  2670.           <Home>        - move to the beginning of the report.
  2671.  
  2672.           <End>         - move to the end of the report.
  2673.  
  2674.           <Grey Plus>   - move down through the report 1/15th of the total
  2675.                           length of the report (see the appendix regarding the
  2676.                           SCROLL BAR later in this manual).
  2677.  
  2678.           <Grey Minus>  - move up through the report 1/15th of the total length
  2679.                           of the report (see the appendix regarding the SCROLL
  2680.                           BAR later in this manual).
  2681.  
  2682.           <Esc>         - return to the menu.
  2683.  
  2684.  
  2685.         These options are available in all reports _except_ the SUMMARY REPORT:
  2686.  
  2687.           <N> - change report format to show a standard (normal) file report.
  2688.                 This is the default if you do not specify either /SD or /CO
  2689.                 when you start CATDISK.
  2690.  
  2691.           <S> - change report format to show sub-directories. If a
  2692.                 sub-directory begins with a tilde (~), that means that the
  2693.                 sub-directory shown is a sub-directory past the first level
  2694.                 (i.e. a sub-directory within a sub-directory). If you wish to
  2695.                 have this report format come up by default when starting
  2696.                 CATDISK, simply add /SD to your command line with which you
  2697.                 invoke CATDISK.
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2704.  
  2705.                                       Page 40
  2706.  
  2707.  
  2708.  
  2709.           <C> - change the report format to any comments you might have entered
  2710.                 for the shown catalog entries. If you wish this display format
  2711.                 to appear by default, use the /CO option when starting CATDISK.
  2712.  
  2713.  
  2714.         Printer-Based Reports
  2715.         ---------------------
  2716.  
  2717.         If your report is going to a printer (LPT1 or LPT2), and you have
  2718.         activated the two-sided report feature of CATDISK, the odd numbered
  2719.         pages will be printed first, followed by a pause enabling you to reload
  2720.         the paper such that the even numbered pages will print on the back side
  2721.         of the odd numbered pages, followed by the even numbered pages.
  2722.  
  2723.         As the report is printed, the filenames or disk volumes (as appropriate
  2724.         to the report) will be echoed to your screen to keep you informed as to
  2725.         CATDISK's progress.
  2726.  
  2727.         While a report is being printed, you may press <Esc> to abandon the
  2728.         report and return you to the previous menu.
  2729.  
  2730.  
  2731.         Disk-Based Reports
  2732.         ------------------
  2733.  
  2734.         Disk reports are treated the same as printer reports, with the
  2735.         exception that the two-sided report feature does not apply.
  2736.  
  2737.         A listing in the same format as the hardcopy report will be produced in
  2738.         a diskette file.  The default name for this file is one with the same
  2739.         name as the current catalog filename with an extension of ".LST".  This
  2740.         may be overridden at the time that the report is generated.  Hitting
  2741.         <Esc> at any time during the generation of the report will abort it and
  2742.         return to the previous menu.
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2770.  
  2771.                                       Page 41
  2772.  
  2773.  
  2774.  
  2775.         Sub-Option #1: Disk Summary
  2776.         ---------------------------
  2777.  
  2778.         Selection of sub-option #1 from the reports menu will cause CATDISK to
  2779.         display an alphabetical list of VOLUME NAMES and some pertinent
  2780.         statistical information  for each.  This option is handy if, say, you
  2781.         have a bunch of utility disks and want to add a 14K utility program to
  2782.         one of them.  This report can be quite useful in making efficient use
  2783.         of existing working diskettes.
  2784.  
  2785.         All the statistical items shown should be self-explanatory, except one;
  2786.         that is, the Slack % factor.  The disks on which DOS stores it files
  2787.         are divided into allocation units called clusters.  The size of each
  2788.         cluster varies with the type and size of disk.  When DOS allocates
  2789.         space on a disk for a file, it is allotted in one cluster units to the
  2790.         file.  Some common cluster sizes are 512 bytes on 160-180K diskettes,
  2791.         and 1024 bytes on 320-360K diskettes.  Some hard disks have larger
  2792.         cluster sizes.
  2793.  
  2794.         Anyway, let's say, for example, that you have a file of 256 bytes.  On
  2795.         a 360K diskette, DOS will allocate 1024 bytes to the file, even though
  2796.         it is only 256 bytes long.  This means that three-quarters of that
  2797.         cluster is unused, or that you have 75% slack for that file.  The
  2798.         figure that you see on the summary report is the overall slack
  2799.         percentage of all the files on the disk.
  2800.  
  2801.         Depending on where you have set your output destination, the following
  2802.         options are applicable:
  2803.  
  2804.         NOTE:   If you select a printer or disk-based report from CATDISK,
  2805.                 you will be asked if you would like the report to be sorted on
  2806.                 volume ID or by descending free disk space.  Simply hit <V> for
  2807.                 the volume ID sort, or hit <F> for the descending free disk
  2808.                 space report.  Hitting <Esc> at this prompt will cause the
  2809.                 report to be aborted.
  2810.  
  2811.         NOTE:   There will also be one additional option available to you from
  2812.                 this report screen.  By pressing the <Tab> key, you can switch
  2813.                 the sorted order of the report between alphabetical volume ID
  2814.                 and descending free disk space.  The starting order in which
  2815.                 the report will appear can be controlled with the /SF command
  2816.                 line option at startup.
  2817.  
  2818.     
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2836.  
  2837.                                       Page 42
  2838.  
  2839.  
  2840.  
  2841.         Sub-option #2: Files For A Volume
  2842.         ---------------------------------
  2843.  
  2844.         Selecting sub-option #2 will cause CATDISK to display an alphabetical
  2845.         list of files for a particular disk.  If you have the report
  2846.         destination set to "ASK", you will be asked for a report location.
  2847.         After the report destination is established, you will be asked for a
  2848.         volume ID.  Simply enter it and hit <Return>, or hit <Esc> to return to
  2849.         the menu without producing a report.
  2850.  
  2851.         Once the report location has been determined, CATDISK will ask you for
  2852.         the volume name to match for the report.  You can either enter the
  2853.         exact volume name to match, or a wild-card entry to match for the
  2854.         report.  If you enter an exact entry, CATDISK will first find it in the
  2855.         summary file.  If it does not exist, you will be notified, and the
  2856.         catalog scan will not even take place.  If you want to obtain a report
  2857.         for a group of volumes, here's how the wildcard matching works:
  2858.  
  2859.         As CATDISK scans your catalog for matches, it does a character by
  2860.         character comparison of the pattern that you specified and the volume
  2861.         name for each entry in your catalog.  As soon as a mismatch occurs, the
  2862.         catalog entry is not included in the report.  Two characters have a
  2863.         special meaning in these comparisons.  The question mark (?) will match
  2864.         any character in the position which the question mark occupies.  The
  2865.         asterisk (*) will match any characters to either the end of the volume
  2866.         name, or the next non-asterisk character in the pattern, if there are
  2867.         any.  As a result of this logic, any characters between two asterisks
  2868.         that may occur in the search pattern are ignored.
  2869.  
  2870.         One special case with the asterisk feature is when a pattern is placed
  2871.         in between two asterisks.  CATDISK will then match any volume that
  2872.         contains the pattern anywhere in the name.
  2873.  
  2874.         To better illustrate, here are some examples:
  2875.  
  2876.           Pattern    Volume ID  Match?
  2877.         ----------- ----------- ------
  2878.  
  2879.         VOLUME 1    VOLUME 1     YES
  2880.         VOLUME 1    VOLUME 2      NO   - not an exact match
  2881.         VOL?????    VOLUME 1     YES   - any 8 char name beginning with "VOL"
  2882.         VOL????2    VOLUME 2     YES   - any 8 char name beginning with "VOL"
  2883.                                          that ends with "2"
  2884.         VOL*1       VOLUME 1     YES   - any name beginning with "VOL" and
  2885.                                          ending in "1" (any number of chars)
  2886.         VOL*1       VOLUME 2      NO   - doesn't end in "1"
  2887.         *1          VOLUME 1     YES   - any name ending in "1" (any number of
  2888.                                          chars)
  2889.         *1          VOLUME 2      NO   - doesn't end in "1"
  2890.         ????????    VOLUME 1     YES   - any 8 char volume name
  2891.         ?????????   VOLUME 2      NO   - volume ID is not 9 characters long
  2892.         *           ANYVOLUME    YES   - any volume ID, any number of chars
  2893.         AB*CD*EF    ABEF         YES   - "CD" in the middle ignored
  2894.         *MISC*      CATMISC1     YES   - Contains "MISC" in the volume name.
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2902.  
  2903.                                       Page 43
  2904.  
  2905.  
  2906.  
  2907.         Note that in the last example, the presence of a leading and trailing
  2908.         asterisk will cause CATDISK to search for the characters enclosed
  2909.         between them as they appear literally.  Wildcard characters must not
  2910.         appear between these delimiters, as they cannot exist in a valid DOS
  2911.         filename (i.e. the volume id) and therefore will not be matched.  For
  2912.         example," *DI?K*" will cause CATDISK to search for "DI?K" in the volume
  2913.         id.  The question mark is not a valid character in a DOS filename,
  2914.         therefore no matches will be found.
  2915.  
  2916.         Optionally, you can leave the volume ID blank.  CATDISK will bring up a
  2917.         point-and-shoot menu from which you can select a volume id from those
  2918.         in your current catalog.  See the section entitled "Selecting A Volume
  2919.         Name From A List" previously discussed in this user manual.
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  2968.  
  2969.                                       Page 44
  2970.  
  2971.  
  2972.  
  2973.         Sub-option #3: Files For An Archive
  2974.         -----------------------------------
  2975.  
  2976.         Selecting sub-option #3 will cause CATDISK to display an alphabetical
  2977.         list of files for a particular archive.  If you have the report
  2978.         destination set to "ASK", you will be asked for a report location.
  2979.         After the report destination is established, you will be asked for a
  2980.         Archive to list.  Simply enter it and hit <Return>, or hit <Esc> to
  2981.         return to the menu without producing a report.  If you wish to obtain a
  2982.         report for a group of similarly named archives, you may use wildcards
  2983.         in your search spec.  Here's how they work:
  2984.  
  2985.         As CATDISK scans your catalog for matches, it does a character by
  2986.         character comparison of the pattern that you specified and the volume
  2987.         name for each entry in your catalog.  As soon as a mismatch occurs, the
  2988.         catalog entry is not included in the report.  Two characters have a
  2989.         special meaning in these comparisons.  The question mark (?) will match
  2990.         any character in the position which the question mark occupies.  The
  2991.         asterisk (*) will match any characters to either the end of the volume
  2992.         name, or the next non-asterisk character in the pattern, if there are
  2993.         any.  As a result of this logic, any characters between two asterisks
  2994.         that may occur in the search pattern are ignored.
  2995.  
  2996.         One special case with the asterisk feature is when a pattern is placed
  2997.         in between two asterisks.  CATDISK will then match any archive that
  2998.         contains the pattern anywhere in the name.
  2999.  
  3000.         To better illustrate, here are some examples:
  3001.  
  3002.         Pattern   Archive ID  Match?
  3003.         --------  ----------  ------
  3004.         MISC1     MISC1        YES
  3005.         MISC1     MISC2         NO   - not an exact match
  3006.         MI???     MISC1        YES   - any 5 char name beginning with "MI"
  3007.         MI??2     MISC2        YES   - any 5 char name beginning with "MI"
  3008.                                        that ends with "1"
  3009.         MI*1      MISC1        YES   - any name beginning with "MI" and ending
  3010.                                     in "1" (any number of chars)
  3011.         MI*1      MISC2         NO   - doesn't end in "1"
  3012.         *1        MISC1        YES   - any name ending in "1" (any number of
  3013.                                        chars)
  3014.         *1        MISC2         NO   - doesn't end in "1"
  3015.         ?????     MISC1        YES   - any 5 char volume name
  3016.         ????????  MISC2         NO   - archive ID is not 8 characters long
  3017.         *         ANYARCH      YES   - any archive ID, any number of chars
  3018.         AB*CD*EF  ABEF         YES   - "CD" in the middle ignored
  3019.         *GAME*    AGAME001     YES   - Contains "GAME" in the archive name
  3020.  
  3021.         Note that in the last example, the presence of a leading and trailing
  3022.         asterisk will cause CATDISK to search for the characters enclosed
  3023.         between them as they appear literally.  Wildcard characters must not
  3024.         appear between these delimiters, as they cannot exist in a valid DOS
  3025.         filename (i.e. the archive id) and therefore will not be matched.  For
  3026.         example," *DI?K*" will cause CATDISK to search for "DI?K" in the
  3027.         archive id.  The question mark is not a valid character in a DOS
  3028.         filename, therefore no matches will be found.
  3029.  
  3030.  
  3031.  
  3032.  
  3033.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3034.  
  3035.                                       Page 45
  3036.  
  3037.  
  3038.  
  3039.         Sub-option #4: Files By Filespec
  3040.         --------------------------------
  3041.  
  3042.         Selecting sub-option #4 will cause CATDISK to display an alphabetical
  3043.         list of files for a DOS or a CATDISK enhanced wildcard spec.  If you
  3044.         have the report destination set to "ASK", you will be asked for a
  3045.         report location.  After the report destination is established, you will
  3046.         be asked for a filespec.  This filespec follows the conventional DOS
  3047.         filespec search conventions including wildcard searches.  Hit <Esc> to
  3048.         return to the menus without generating a report.
  3049.  
  3050.         Examples:
  3051.  
  3052.                *.*        - search for everything
  3053.                *          - same as *.*
  3054.                *.         - search for files with no extension
  3055.         CATDISK*.*        - search for files starting with CATDISK and having
  3056.                             any file extension
  3057.         CATDISK*          - same as CATDISK*.*
  3058.         CATDISK*.         - search for files starting with CATDISK and having
  3059.                             no file extension
  3060.                *.COM      - search for files ending in .COM
  3061.               A*.EXE      - search for files starting with A and ending in .EXE
  3062.          CATDISK.EXE      - search specifically for CATDISK.EXE
  3063.                *.?Q?      - search for files with an extension containing Q as
  3064.                             its second character
  3065.               ??.DOC      - search for files with two letters as it filename
  3066.                             and .DOC as its extension
  3067.  
  3068.         Please refer to the DOS manual for further information on file
  3069.         searching patterns.
  3070.  
  3071.         In addition to the standard DOS wildcard matching specifications,
  3072.         CATDISK adds capabilities similar to the pattern matching discussed
  3073.         earlier in the manual under volume name matching and archive id
  3074.         matching.  To apply it to a filename, simply split the filename into
  3075.         its two sections (the part before the period is referred to as the
  3076.         name, and the part after the period is the extension), and apply the
  3077.         principals to each part.  A couple of examples would be:
  3078.  
  3079.             *D.*   - match any filename whose name ends in "D" and has any
  3080.                      extension.
  3081.           C?T*.EXE - match any filename whose name has a "C" in the first
  3082.                      position, any character in the second position, a "T" in
  3083.                      the third position, and has an extension of ".EXE".
  3084.              *.*M  - match any file with any extension that ends in "M".
  3085.            C*K.*   - match any file with any extension whose name starts with
  3086.                      "C" and ends with "K".
  3087.          *DISK*.*  - match any file whose name contains the characters "DISK".
  3088.  
  3089.         Note that in the last example, the presence of a leading and trailing
  3090.         asterisk will cause CATDISK to search for the characters enclosed
  3091.         between them as they appear literally.  Wildcard characters must not
  3092.         appear between these delimiters, as they cannot exist in a valid DOS
  3093.         filename and therefore will not be matched.  For example," *DI?K*.*"
  3094.         will cause CATDISK to search for "DI?K" in the files name.  The
  3095.         question mark is not a valid character in a DOS filename, therefore no
  3096.         matches will be found.
  3097.  
  3098.  
  3099.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3100.  
  3101.                                       Page 46
  3102.  
  3103.  
  3104.  
  3105.         Although this is a slight departure from the DOS standard for file
  3106.         pattern matching, I'm sure that you will find that these extensions add
  3107.         a little more flexibility and power to CATDISK's reporting
  3108.         capabilities.
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3166.  
  3167.                                       Page 47
  3168.  
  3169.  
  3170.  
  3171.         Sub-option #5: Files By Comment
  3172.         -------------------------------
  3173.  
  3174.         Selecting sub-option #5 will cause CATDISK to display a list of files
  3175.         in accordance with a comment search spec that you supply.  After
  3176.         selecting a report destination, you will be asked for a comment search
  3177.         spec that you wish the report to be based on.
  3178.  
  3179.         Just enter the string that you want to search for in the catalog's
  3180.         comments section and hit <Enter>, or hit <Esc> to abort the process
  3181.         without generating a report.
  3182.  
  3183.         Here's how the comments are sourced for your search spec.  You enter a
  3184.         "phrase" or "substring" that you want to search for in the file
  3185.         comments.
  3186.  
  3187.         The "phrase" may be an entire comment that you want, it can be just one
  3188.         word, or even just one letter.  When catdisk compares your "phrase" to
  3189.         a comment, it checks to see if that "phrase" is contained anywhere in
  3190.         that comment.  If it does, that file will appear in your report.
  3191.  
  3192.         Example:   "SOURCE" would match:    CATDISK V4.13 source code
  3193.                                             CATDISK V4.13 Source code
  3194.                                             CATDISK V4.13 SOURCE CODE
  3195.                                             Source
  3196.                                                      ... etc ...
  3197.  
  3198.         Leaving the comment entry blank will produce a report containing only
  3199.         the catalog entries that have no comment.
  3200.  
  3201.         Please note:  Several users have asked for wild cards in the comment
  3202.         search (eg.  they might not know whether they had "Word Processor" or
  3203.         "Word Proc" for a comment).  This is not really necessary in this case,
  3204.         as, in the above case, entering "PROC" would match both comments.
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3232.  
  3233.                                       Page 48
  3234.  
  3235.  
  3236.  
  3237.         Sub-option #6:  Sorted Full File Listings
  3238.         -----------------------------------------
  3239.  
  3240.         This option, if viewed on the screen will product a report in the same
  3241.         manner as sub-option #5, except that ALL files in the catalog will be
  3242.         included in the list.  It is similar to choosing sub-option #5 and
  3243.         searching for "*.*".
  3244.  
  3245.         If you have the report destination set to "ASK", you will be asked for
  3246.         a report location before any further action takes place.
  3247.  
  3248.         You may sort the full list on various criteria.  Currently, you can
  3249.         sort by filename, file extension, subdirectory, volume id, archive id,
  3250.         comment, file date/time (descending order), or file size (descending or
  3251.         ascending order).
  3252.  
  3253.         To select a criteria, simply hit the number beside it, or select it
  3254.         from the menu using CATDISK's menu selection methods.  The rest is
  3255.         automatic.
  3256.  
  3257.         If, during the sorting phase, which occurs for each option, with the
  3258.         exception of option #1, an error occurs, the process will be aborted
  3259.         and no report will be generated.
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3298.  
  3299.                                       Page 49
  3300.  
  3301.  
  3302.  
  3303.         Sub-option #7: Unique Files Only & Sub-option #8: Duplicate Files Only
  3304.         ----------------------------------------------------------------------
  3305.  
  3306.         Selecting sub-option #7 will cause CATDISK to display a listing of
  3307.         files in your catalog that exist only once.  Selecting sub-option #8
  3308.         will cause CATDISK to display a listing of files that occur more than
  3309.         once in your catalog.
  3310.  
  3311.         The criteria for these two reports is based solely on the filename, and
  3312.         optionally, on the file size (you will be asked whether or not you want
  3313.         it to be included before the catalog scan takes place), and not other
  3314.         items such as subdirectory, file date or file size.  you will be given
  3315.         the option to include or not to include the file size as a criteria in
  3316.         determining a file's uniqueness when you initiate one of these two
  3317.         sub-options.
  3318.  
  3319.         When either of these reports is generated, a full scan will be made
  3320.         through the catalog file to determine which files should be included in
  3321.         the report.  The reason for this is due to the method that CATDISK uses
  3322.         in comparing filenames to determine whether they are duplicate or
  3323.         unique.
  3324.  
  3325.         If, during the scanning process, CATDISK runs into a disk problem, the
  3326.         report will be aborted.
  3327.  
  3328.         Due to the method by which CATDISK scans the catalog, there is a
  3329.         possibility that duplicate files may appear in the unique file reports
  3330.         and vice versa when file size is used as a criteria if the given
  3331.         entries being compared are not right together in the catalog file.  An
  3332.         example may make this clearer:
  3333.  
  3334.         Filename.Ext  Volume ID    File Size
  3335.  
  3336.         TEST    .GIF  GIF0001        123,456
  3337.         TEST    .GIF  GIF0002        123,789
  3338.         TEST    .GIF  GIF0003        123,456
  3339.  
  3340.         In the unique file report, for example, if the file size is omitted
  3341.         from the search criteria, the report will show none of the above three
  3342.         files, which would be correct.
  3343.  
  3344.         If, however, the file size is included, all three of the files will
  3345.         show up due to the fact that the second entry in the file list has a
  3346.         different file size.  The first file is compared to the second one, and
  3347.         the second one is compared to the third during the sequential search of
  3348.         the catalog.  Due to the possibility that there can be many files of
  3349.         the same name occurring in the catalog file, this cannot be currently
  3350.         circumvented.
  3351.  
  3352.         A similar situation can happen in the duplicate files report.  Leaving
  3353.         the file size out of the criteria will yield the correct results.
  3354.         Including it may cause all three files to be left out of the report for
  3355.         the same reasons as in the unique file report.
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3364.  
  3365.                                       Page 50
  3366.  
  3367.  
  3368.  
  3369.         Sub-option #9: Volume Summary/Contents
  3370.         --------------------------------------
  3371.  
  3372.         This report is like combining the summary report with a full file
  3373.         listing.  CATDISK will print each line from your summary report,
  3374.         followed by a complete listing of files contained on that disk.
  3375.  
  3376.         Due to the nature of this report and the methodology that CATDISK uses
  3377.         to generate it, it is not possible to view this report on your screen.
  3378.         A printer location or a disk file must be selected in order to produce
  3379.         this report.
  3380.  
  3381.         If you instruct CATDISK to send this report to the screen, you will get
  3382.         an error message informing you of the above requirements.
  3383.  
  3384.  
  3385.         Sub-option <Esc>: Return To Main Menu
  3386.         -------------------------------------
  3387.  
  3388.         Hitting <Esc> will return you to CATDISK's main menu.
  3389.  
  3390.  
  3391.  
  3392.  
  3393.  
  3394.  
  3395.  
  3396.  
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3430.  
  3431.                                       Page 51
  3432.  
  3433.  
  3434.  
  3435.         OPTION <F2> - TEMPORARILY EXIT TO DOS
  3436.         -------------------------------------
  3437.  
  3438.         This option, although not really necessary, has been added in response
  3439.         to the numerous requests that I have had for this feature (shows that I
  3440.         am really paying attention to those suggestions, eh?).  By selecting
  3441.         this option, CATDISK will be temporarily suspended and you will be
  3442.         returned to the DOS prompt.  You may carry out any normal function that
  3443.         you would ordinarily be able to carry out from DOS, provided that there
  3444.         is enough memory remaining in which to run your desired program.
  3445.  
  3446.         Please note that if you have the disk cache active at the time you use
  3447.         this function, the contents of the cache will be flushed and cleared
  3448.         before calling DOS.  This will not affect any data already on disk.
  3449.  
  3450.         When you are finished with DOS, and wish to return to CATDISK, simply
  3451.         type "EXIT" and hit <Return> to return to CATDISK.  Please be sure and
  3452.         replace any disks that you had in your drives before returning to
  3453.         CATDISK.
  3454.  
  3455.         Note that although the <F2> option does not appear on any of CATDISK's
  3456.         other menus (settings & toggles, reports & inquiries, or the report
  3457.         destination selection menu), you may press <F2> from any of these menus
  3458.         to temporarily exit to DOS.  When you return from DOS, you will be
  3459.         returned to the particular menu from which you shelled out to DOS.
  3460.  
  3461.         Possible errors that you may encounter when you use can vary greatly.
  3462.  
  3463.         Possibilities are:  1) There is not enough memory to load a second copy
  3464.                                of the command interpreter (usually
  3465.                                COMMAND.COM), or that memory has been corrupted
  3466.                                by a resident program.
  3467.  
  3468.                             2) If you get an error after returning from DOS, it
  3469.                                usually means that you've loaded a resident
  3470.                                program while out in DOS.  You should refrain
  3471.                                from doing so.
  3472.  
  3473.                             3) Generally, this means that CATDISK was unable to
  3474.                                find COMMAND.COM on the drive and directory
  3475.                                defined by the SET COMSPEC= environment string
  3476.                                (see the DOS manual for details on the SET
  3477.                                command).  This is usually set to the location
  3478.                                from which COMMAND.COM was loaded when the
  3479.                                system was booted. If COMMAND.COM was not found
  3480.                                at the boot location, the root directory of the
  3481.                                current drive is attempted.
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3496.  
  3497.                                       Page 52
  3498.  
  3499.  
  3500.  
  3501.         OPTION <drive_letter>: SHOW DISK DIRECTORY
  3502.  
  3503.         To activate this feature, simply type the drive letter of the disk
  3504.         whose directory you wish to view.  If you haven't included the /NW
  3505.         option in your command line when you started CATDISK,you will be
  3506.         prompted to insert a disk for drive D where D is the drive letter that
  3507.         you typed.
  3508.  
  3509.         You will then be asked for a filespec to match.  This is the same as
  3510.         the filespec prompt in OPTION #9 - SHOW SELECTED FILES.  Upon doing
  3511.         this, the label and directory contents will be read just like they
  3512.         would if they were about to be cataloged, but instead of adding them to
  3513.         your catalog, they will be shown directly on the screen in the same
  3514.         format as option #7 - Show Files For A Volume.  The archive scanning
  3515.         feature functions as normal throughout the program.
  3516.  
  3517.         Upon entering the search spec, scanning of the catalog will
  3518.         commence.  If you have status indicators turned on, a counter  will
  3519.         increment each time a matching file is found.  If at the and of the
  3520.         search, no files were found, an error message will be issued and you
  3521.         will be returned to the main menu.
  3522.  
  3523.         When the search has completed successfully, the file names will be
  3524.         shown alphabetically, along with the volume name, archive name, and
  3525.         other directory information for that file.
  3526.  
  3527.         For a list of options available, please see the section entitled
  3528.         "SCREEN REPORT OPTIONS AVAILABLE" in this manual.
  3529.  
  3530.  
  3531.  
  3532.         OPTION ESC:  EXIT TO DOS
  3533.  
  3534.         Select this option when you are finished with CATDISK to terminate its
  3535.         operation.  Upon exit, you will be returned to the DOS prompt.
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3562.  
  3563.                                       Page 53
  3564.  
  3565.  
  3566.  
  3567.                               APPENDIX A - THE SCROLL BAR
  3568.  
  3569.         When bringing up a screen report, you may have noticed a hatched bar on
  3570.         the left border of the screen with an inverse 'T' at the top of it and
  3571.         an inverse 'B' at the bottom.  This is a scroll bar, which indicates
  3572.         roughly where you are located along the full length of the current
  3573.         report.  Additionally, this feature will allow you to roughly position
  3574.         yourself in the report by hitting the <Grey Plus> and <Grey Minus>
  3575.         keys.  These keys will move you forward and backward respectively along
  3576.         this scroll bar.  These moves correspond to a move of one fifteenth of
  3577.         the total length of the report in the selected direction, as will be
  3578.         reflected in the page number which will be automatically set.
  3579.  
  3580.         The scroll bar position will also wrap from the top to the bottom if
  3581.         you are at the top and hit the <Grey Minus> key.  The reverse is also
  3582.         true for the <Grey Plus> key.
  3583.  
  3584.         In a long report, this represents a much nicer way of getting to, say,
  3585.         the files beginning with "R" without having to hit the <PgDn> key a
  3586.         hundred times.  Remember... the scroll bar is used to ROUGHLY position
  3587.         yourself among a group of files in a screen report.
  3588.  
  3589.         This scroll bar will appear in the point-and-shoot volume id selection
  3590.         screen as well.  Its functionality is much the same as that discussed
  3591.         above for reports.
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3628.  
  3629.                                       Page 54
  3630.  
  3631.  
  3632.  
  3633.                              APPENDIX B - ARCHIVE SUPPORT
  3634.  
  3635.         This version of CATDISK currently supports the archive utilities from
  3636.         System Enhancement Associates and PKWare, PAK files (similar to ARC
  3637.         files) created by the PAK utility from NoGate Consulting, ZIP files
  3638.         created by PKWare's PKZIP utilities, LZH files created by the LHARC
  3639.         utility from Haruyasu Yoshizaki, LZS files created by the LARC utility
  3640.         from K. Miki, DWC files created by the DWC utility from Dean W. Cooper,
  3641.         and the public domain Library Utility (LU).
  3642.  
  3643.         CATDISK can extract directory information from archives created with
  3644.         SEAWARE'S ARC utility, version 5.30 or earlier, PKWare's PKPAK version
  3645.         3.61 or earlier, or any compatible archive generating program.  These
  3646.         files commonly have a file extension of .ARC, and any files with this
  3647.         extension will be examined by CATDISK to see if it is a valid archive.
  3648.         If so, the directory information of each file in the archive will be
  3649.         extracted and added to the catalog if the Auto Archive Extraction
  3650.         feature is turned ON.  Files extracted from an ARC file will have a
  3651.         file attribute of "*ARC".
  3652.  
  3653.         Similar to the above, any files with a .PAK extension will be examined,
  3654.         and if appropriate, the directory information will be extracted from
  3655.         the file in question.  Files extracted from a PAK file will have a file
  3656.         attribute of "*PAK".
  3657.  
  3658.         ARC or PAK files created with utilities other than the ones listed
  3659.         above should work with CATDISK, but are not guaranteed.
  3660.  
  3661.         Files created with PKWare's PKZIP family of utilities are fully
  3662.         supported.  These files usually have an extension of .ZIP, and any file
  3663.         found with this extension will be examined by CATDISK to see if it is a
  3664.         valid ZIP file.  If this is so, and the Auto Archive Extraction Feature
  3665.         is turned ON, the directory information of each file in the library
  3666.         will be extracted and added to the catalog.  Files extracted from a ZIP
  3667.         file will have a file attribute of "*ZIP".  If the ZIP file contains
  3668.         comments, the first 30 characters will be extracted and included in
  3669.         your catalog file.
  3670.  
  3671.         ZIP files, in addition to supporting comment entries for each file
  3672.         contained, can also have a main comment for the ZIP file itself.  When
  3673.         CATDISK reads ZIP files and finds a main comment, it will insert that
  3674.         main comment in the catalog file for any entries in the ZIP file that
  3675.         do not already have comments.
  3676.  
  3677.         Although ZIP files can contain subdirectory information, this is not
  3678.         the subdirectory that will appear in the catalog listing.  The reason
  3679.         for this is due to the fact that the primary purpose of CATDISK is to
  3680.         be able to locate a given file.  In order to be able to do so, the
  3681.         subdirectory of the ZIP file itself is shown.  The destination of the
  3682.         file when being UNZIPPED is not relevant.
  3683.  
  3684.         Files created by the ARJ utility by Robert K. Jung that have a file
  3685.         extension of .ARJ are fully supported in the same manner as ZIP files.
  3686.         Such files have a file extension of .ARJ and any catalog entries that
  3687.         came from an ARJ file will have a file attribute of "*ARJ".
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3694.  
  3695.                                       Page 55
  3696.  
  3697.  
  3698.  
  3699.         Files created with Haruyasu Yoshizaki's LHA utility (formerly called
  3700.         LHARC) are fully supported.  These files commonly end with a .LZH
  3701.         extension.  Any files with this extension will be examined by CATDISK
  3702.         to see if it is a valid LHARC file.  If so, and you wish the directory
  3703.         contents to be extracted (via the program setting), the process will be
  3704.         carried out.  Files extracted from a LZH file will have a file
  3705.         attribute of "*LZH".
  3706.  
  3707.         Files created by the LARC utility from K. Miki are supported in the
  3708.         same way as those created by the LHARC utility mentioned above.  Files
  3709.         extracted from these files will have a file attribute of "*LZS".
  3710.  
  3711.         Files with a .ZOO extension will be examined to determine whether they
  3712.         are a valid ZOO file.  If so, and Archive extraction is enabled, the
  3713.         directory contents of the file will be read and included in the catalog
  3714.         file.  Files extracted from ZOO files will have the attribute "*ZOO".
  3715.         If the ZOO file contains comments, the first 30 characters will be
  3716.         extracted and included in your catalog file.
  3717.  
  3718.         Files with a .DWC extension will be checked to determine whether they
  3719.         are a valid DWC file.  If so,and archive extraction is enabled, the
  3720.         directory contents of the file will be read and included in the catalog
  3721.         file.  Files extracted from DWC files will have the attribute "*DWC".
  3722.         If the DWC file contains comments, the first 30 characters will be
  3723.         extracted and included in your catalog file.
  3724.  
  3725.         Files created by the archive utility HYPER, having a file extension of
  3726.         .HYP will be examined.  If they are a valid HYPER archive file, the
  3727.         directory contents from this file will be included in the catalog file.
  3728.         Files extracted from HYPER archives will have the attribute "*HYP".
  3729.  
  3730.         Files created by the Library Utility (LU) and conform to the fifth
  3731.         revision of the formal definition of the library file format are also
  3732.         fully supported.  These files commonly have a file extension of .LBR,
  3733.         and any files with this extension will be examined by CATDISK to see if
  3734.         they are valid .LBR files.  If this is so, and the Auto ARCHIVE
  3735.         Extraction Feature is turned ON, the directory information of each file
  3736.         in the library will be extracted and added to the catalog.  Files
  3737.         extracted from a LBR file will have an attribute of "*LBR".
  3738.  
  3739.         Although not an archive file in the formal sense of the word, a GIF
  3740.         file (stands for Graphics Interchange Format) is a special file format
  3741.         that was developed by CompuServe in order to allow many different types
  3742.         of computers to be able to view a graphics image without having to
  3743.         modify the file itself.  GIF viewers are available on a wide variety of
  3744.         hardware platforms to allow you to look at the images contained within
  3745.         a GIF file.  These files can come in a very wide variety of resolutions
  3746.         and color combinations.  CATDISK can look into a GIF file and extract
  3747.         this resolution and color information and include it as a default
  3748.         comment for that GIF file.  For example, a picture that may be 640 by
  3749.         480 pixels with 256 colors would have a comment entry of
  3750.         "1024x768x256".
  3751.  
  3752.         Currently, the GIF87a and GIF89a are supported.
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3760.  
  3761.                                       Page 56
  3762.  
  3763.  
  3764.  
  3765.                            APPENDIX C - SUPPORT AND UPDATES
  3766.  
  3767.         As I said in the introduction, I will only offer advice and technical
  3768.         support to those who are registered CATDISK users.  Users who do
  3769.         contribute will be notified when updates and new products are
  3770.         available. Anyone wishing to offer advice and suggestions are most
  3771.         welcome to do so.
  3772.  
  3773.         I may be reached on CompuServe at I.D. #  73307,333, or on our support
  3774.         BBS "The Shareware Connection" in WATERLOO, Ontario, Canada, under my
  3775.         name, Rick Hillier.
  3776.  
  3777.         You may also correspond via your FAX machine, if you have access to
  3778.         one. My FAX number is (519)-884-4887.  This is the best daytime number
  3779.         at which to get an immediate response.
  3780.  
  3781.         Telephone support available to registered users only.  My voice line is
  3782.         (519)-888-6763.  If you get our answering machine, leave a detailed
  3783.         message regarding your question and/or problem, and I will return your
  3784.         call.
  3785.  
  3786.         PLEASE NOTE THAT IN THE EVENT THAT NO ONE IS AVAIALABLE TO TAKE A
  3787.         SUPPORT CALL, IT IS OUR POLICY TO RETURN CALLS FROM NON-REGISTERED
  3788.         USERS COLLECT ON AN AS-AVAILABLE BASIS.
  3789.  
  3790.         If you are not a registered user and do have questions, the best place
  3791.         to leave them is in an E-mail message on either on The Shareware
  3792.         Connection or on CompuServe.
  3793.  
  3794.         Those of you who register your copy of CATDISK and wish to receive an
  3795.         update to the latest version (from me and not the support BBS), please
  3796.         be sure and use the registration form to indicate that you wish to
  3797.         receive the latest version on diskette.  If you do not have the
  3798.         registration form, you can download it from "The Shareware Connection"
  3799.         if you have a modem.  If not, please send a note with your registration
  3800.         fee indicating the CATDISK version that you are currently using.
  3801.         Current prices (in addition to the base registration fee of $25.00) are
  3802.         $10.00 for a 360K 5.25" disk and $12.50 for 720K 3.5" disk.
  3803.  
  3804.         Optionally, you may include a diskette and diskette mailer with your
  3805.         registration fee plus $5.00 to cover shipping costs, and I will send
  3806.         you the latest version of CATDISK.
  3807.  
  3808.         If there have been no upgrades available since your current release,
  3809.         your upgrade will be held until such time as one becomes available,
  3810.         unless you specify that you just want the current release on diskette.
  3811.  
  3812.  
  3813.         ATTENTION OUT OF TOWN CATDISK USERS
  3814.  
  3815.         The most up to date version of CATDISK is always available on The
  3816.         Shareware Connection, which may be reached at (519)-888-6924, 24 hrs. a
  3817.         day.  In order to be able to access a new version of CATDISK, you must
  3818.         be a registered user and you must have taken the support BBS option as
  3819.         outlined on the registration form.  This option will allow you to
  3820.         obtain perpetual upgrades to the CATDISK program, or any other
  3821.         shareware offering that may be made in the future.
  3822.  
  3823.  
  3824.  
  3825.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3826.  
  3827.                                       Page 57
  3828.  
  3829.  
  3830.  
  3831.         This option involves a $5.00 access fee on the board over and above the
  3832.         base registration fee, and will allow you perpetual access to the
  3833.         software available in the data libraries of this BBS system, including
  3834.         CATDISK itself.
  3835.  
  3836.         You can connect with The Shareware Connection at speeds up to 14400
  3837.         baud, allowing a download of the complete CATDISK package in under 3
  3838.         minutes if you connect at that speed.  At 2400 baud, the complete
  3839.         package can be downloaded in about 19 minutes.
  3840.  
  3841.         Please note that if you are not a regular member of this BBS, or
  3842.         haven't taken advantage of the above upgrade offer, YOU WILL NOT BE
  3843.         ABLE TO ACCESS THE PROGRAM.
  3844.  
  3845.         If you do not wish to have a BBS membership, you can still see
  3846.         what changes and revisions have been made to date by going to the
  3847.         bulletins section of the board.  You do not have to be a registered BBS
  3848.         or CATDISK user to use this feature.
  3849.  
  3850.         All CATDISK documentation, including the revision history, readme file,
  3851.         and registration forms are available to the public on this system.  If
  3852.         you received an incomplete CATDISK package from a vendor or bulletin
  3853.         board system, you can supplement missing documentation directly from
  3854.         the support BBS.
  3855.  
  3856.         The electronic mail feature of the board is also fully accessible for
  3857.         leaving feedback and/or suggestions.
  3858.  
  3859.  
  3860.         -----------------------------------------------------------------------
  3861.  
  3862.  
  3863.         If you do have a question, or a bug report, or whatever, in your
  3864.         correspondence, please indicate the following:
  3865.  
  3866.         1)  The version of CATDISK that you are using.
  3867.         2)  The version of DOS that you are using.
  3868.         3)  Your hardware configuration (Model, memory size, printer, etc.)
  3869.         4)  Any resident software that you have loaded in memory at the time.
  3870.             (i.e. Sidekick, SuperKey, Disk Caches, Print Spoolers, Ramdisks,
  3871.             etc.)
  3872.  
  3873.         This information will help me to track any problems and to suggest
  3874.         reasonable solutions to your problems.
  3875.  
  3876.  
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3892.  
  3893.                                       Page 58
  3894.  
  3895.  
  3896.  
  3897.                           APPENDIX D - QUESTIONS AND ANSWERS
  3898.  
  3899.         As CATDISK has developed over the past while, I have received many
  3900.         questions regarding the operation of CATDISK.  The most common are
  3901.         addressed in this section of the manual.
  3902.  
  3903.         Q. When I go to catalog a new disk, CATDISK aborts the catalog file
  3904.            update with an error message that the disk is full, even though
  3905.            there is still room on the disk containing the catalog files.
  3906.  
  3907.         A. When CATDISK updates a catalog file, it does so by merging the new
  3908.            information in with the old, building a new file from the old in the
  3909.            process.  The catch here is that, at the end of the catalog file
  3910.            update, BOTH files actually exist, thereby taking up roughly double
  3911.            the size of the original catalog file.  At the end of this
  3912.            procedure, if successful, CATDISK deletes the old file and renames
  3913.            the new temporary file to what the original catalog file was called.
  3914.            The reason this is necessary is that, while re-cataloging a disk,
  3915.            there is a possibility that files were removed from that disk.  This
  3916.            method of updating the catalog provides a convenient mechanism for
  3917.            removing those files from the catalog.
  3918.  
  3919.         Q. Is there a way to set the default settings as found in the settings
  3920.            and toggles menu, such as the printer report type, double sided
  3921.            reports, and the auto comment feature?
  3922.  
  3923.         A. All settings as found in the settings & toggles menu can be
  3924.            initialized the way you would like them by adding command line
  3925.            options after the CATDISK command when you start the program.
  3926.            Additionally, these options can be conveniently stored in a CATDISK
  3927.            environment variable so you don't have to type them in every time
  3928.            you start CATDISK.  See the section "STARTING CATDISK" in this user
  3929.            manual for full details.
  3930.  
  3931.         Q. CATDISK currently supports archive file comments in ZIP, ZOO, ARJ
  3932.            and DWC files.  Would it be possible to extract those from ARC files
  3933.            as well?
  3934.  
  3935.         A. ARC file comments were a non-standard extension provided by PKWare's
  3936.            PKARC/PKPAK series of archivers, and as such will not be supported
  3937.            at this time.
  3938.  
  3939.         Q. Would it be possible for CATDISK to support ARCHIVES within
  3940.            ARCHIVES?
  3941.  
  3942.         A. Unfortunately, the answer is no.  In order to read the directory of
  3943.            an archive within another archive file, the original one must first
  3944.            be expanded into its separate files.  Firstly, with the ever
  3945.            evolving compression methods employed with new versions of the
  3946.            archive utilities, this would be beyond the scope of this program.
  3947.            Secondly, there would always be the possibility of overwriting an
  3948.            existing file of the same name.  It's just not feasible.
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  3958.  
  3959.                                       Page 59
  3960.  
  3961.  
  3962.  
  3963.         Q. Is it possible for CATDISK to support file categories?
  3964.  
  3965.         A. Indirectly, CATDISK already supports file categories.  When CATDISK
  3966.            searches your catalog by comment via option <F2>, it is really
  3967.            performing a keyword search (i.e. any comment that contains the
  3968.            search item anywhere in its body will show in the report).  In a
  3969.            sample scenario, you could come up with a list of three letter
  3970.            abbreviations for your category list (eg. WIN for Windows, SPR for
  3971.            Spreadsheets, DBS for Database, COM for Communications, etc.) and
  3972.            start each comment with these categories.  By searching for "WIN",
  3973.            you can bring up a list of files in that category.  By sorting on
  3974.            comment, you can bring up a list of filenames sorted by category.
  3975.            Your imagination is the only limiting factor.
  3976.  
  3977.         Q. In the summary report, I see disk entries for which the amount of
  3978.            free space and the amount of space used adds up to more than the
  3979.            capacity of the disk itself.  The % slack factor is also wrong.
  3980.  
  3981.         A. You probably have a corrupted file allocation table on that disk,
  3982.            and could be in for some serious trouble.  Format a fresh disk and
  3983.            transfer the files to it, and re-catalog it from that new disk.
  3984.  
  3985.         Q. After starting the cataloging process on a diskette, I discovered
  3986.            that the label on the diskette was wrong.  Would it be possible to
  3987.            abort the process, change the label and start over?
  3988.  
  3989.         A. Once the cataloging process is started, it cannot be stopped.  If
  3990.            you've run into a situation like that above, let CATDISK finish the
  3991.            task, and use option #3 to change the label on the diskette.
  3992.            CATDISK has a mechanism to automatically change the old volume label
  3993.            to the new one throughout the catalog files.  It's quick and
  3994.            painless.
  3995.  
  3996.         Q. We have file comments for each file entry in the catalog file.
  3997.            Would it be possible to have comments for each disk in the summary
  3998.            file?
  3999.  
  4000.         A. At present, no, although this is not carved in stone.  The main
  4001.            reason for this is that CATDISK keeps the entire disk summary in
  4002.            memory at all times.  A comment on each disk would significantly
  4003.            increase the memory requirements of CATDISK.
  4004.  
  4005.         Q. I have some self-booting games.  Would it be possible to create a
  4006.            dummy entry for that disk in the catalog?
  4007.  
  4008.         A. Doing this would defeat the purpose for which CATDISK was written.
  4009.            Self-booting games (those that CATDISK won't read) do not have a
  4010.            directory in the conventional sense.  As there are no files per se
  4011.            there is nothing to look for on the diskette.  You need only locate
  4012.            the disk itself in order to use it.
  4013.  
  4014.        
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4024.  
  4025.                                       Page 60
  4026.  
  4027.  
  4028.  
  4029.         Q. I have many disks with numerous insignificant files on them such as
  4030.            printer drivers, etc.  Would it be possible to catalog only selected
  4031.            files from these disks?
  4032.  
  4033.         A. Unfortunately, not at this time.  In order to keep the shareware
  4034.            version of CATDISK as simple to use as possible, all files get
  4035.            cataloged hands free.  However, CATDISK PLUS, a commercial release
  4036.            of this program with many enhancements described in more detail in a
  4037.            later appendix, will handle this type of operation.
  4038.  
  4039.         Q. When cataloging my hard drive, CATDISK appears to be scanning for
  4040.            all the files, but I list the files for it, some are missing.
  4041.  
  4042.         A. Although CATDISK appears to be scanning all of your directories and
  4043.            archives for file entries, it has an internal limitation of being
  4044.            able to remember only the first 5000 files that it sees.  After it
  4045.            reaches this number, it simply skips over the remaining entries.
  4046.  
  4047.         A. Another reason that this may occur, especially if your disk has less
  4048.            than 5000 entries is that the missing files may match a filespec set
  4049.            in the EXCLUDE FILES LIST that can be changed in the CDISKCFG
  4050.            utility.  Check that list out to see if this is the case.
  4051.  
  4052.         Q. Why does CATDISK slow down as my catalog files grow larger.
  4053.  
  4054.         A. As CATDISK catalogs each disk, it must make a pass through your data
  4055.            file to determine whether or not any files have been deleted or
  4056.            changed, so that the catalog file can be updated accordingly.  Many
  4057.            other disk catalogers on the market that outperform CATDISK in their
  4058.            cataloging operation retain the entire catalog in RAM.  While this
  4059.            is fast, there are two problems with it.
  4060.  
  4061.            Firstly, this imposes an extreme limitation on their ultimate
  4062.            capacity in terms of how many disks and files you can catalog.  If
  4063.            you are serious at all about maintaining a catalog of all your files
  4064.            and that your library will possibly grow to many files, these types
  4065.            of catalogers are not at all suitable for your usage.
  4066.  
  4067.            Secondly, if you should experience a power outage before you've
  4068.            saved your work, you can kiss that work good-bye.  By manipulating
  4069.            data on-disk, CATDISK does catalog your disks at a slower rate than
  4070.            the above mentioned type of cataloger, but it guarantees the
  4071.            integrity of your work.  We have also developed some very fast
  4072.            catalog updating routines, so any slowdown will be kept to a minimum
  4073.            while guaranteeing the integrity of your catalog file.
  4074.  
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4090.  
  4091.                                       Page 61
  4092.  
  4093.  
  4094.  
  4095.                   APPENDIX E - CATLOOK - COMMAND LINE LOOKUP UTILITY
  4096.  
  4097.         CATLOOK is a stand alone reporting utility provided with CATDISK.  It
  4098.         can come in handy on occasions when you either need to generate a quick
  4099.         and dirty report without having to run CATDISK itself, or when you need
  4100.         to generate a report after shelling out to DOS from within an
  4101.         application and there is not enough free memory left over to run
  4102.         CATDISK itself.  CATLOOK will run in 64K of free memory.
  4103.  
  4104.         A summary of the usage of CATLOOK follows:
  4105.  
  4106.         CATLOOK parameters (each must be separated by a slash or a space)
  4107.  
  4108.            /Ffilename - Use this file for the catalog (Default is CATDISK).
  4109.                         NOTE:  No space is allowed between the filename and the
  4110.                                /F.
  4111.            /Px        - Set printer output format to report type x, where x is:
  4112.                         0 - Filenames + Statistics     1 - Filenames + Comments
  4113.                         2 - Filenames + Statistics + Comments
  4114.            /S         - Show a summary report.
  4115.            /Vvolume   - Show files for a volume report for the volume label
  4116.                         specified.
  4117.            /Aarchive  - Show files for an archive report for the archive
  4118.                         specified.
  4119.            /Wpattern  - Show files for a DOS wildcard spec based on the pattern
  4120.                         given.
  4121.            /Ccomment  - Show files containing the comment substring specified.
  4122.            /U         - Show all files that are unique in the catalog file.
  4123.            /D         - Show all files that have duplicates in the catalog
  4124.                         file.
  4125.            /SIZE      - Use file size as an additional criteria in generating
  4126.                         the unique/duplicate file reports.
  4127.  
  4128.            /Ex        - Show everything sorted by x, where x is:
  4129.                         0 - File Name    1 - File Extension  2 - Subdirectory
  4130.                         3 - Volume Name  4 - Archive ID      5 - Comment
  4131.                         6 - Date/Time
  4132.  
  4133.  
  4134.         Due to the simplicity of this utility, the reports generated by CATLOOK
  4135.         are not paginated, but rather produced with one heading at the top of
  4136.         the report followed by the appropriate listings (equivalent to setting
  4137.         the number of lines per page equal to 0 in the configuration utility).
  4138.  
  4139.         The output from CATLOOK can be redirected to a printer or disk file by
  4140.         using the standard DOS method if I/O redirection.  For example:
  4141.  
  4142.           "CATLOOK /S >PRN" (without the quotes) - this will send a summary
  4143.                                                    report to your printer.
  4144.  
  4145.           "CATLOOK /S >LISTING.TXT" - this will send the summary report to a
  4146.                                       disk file called "LISTING.TXT".
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.  
  4155.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4156.  
  4157.                                       Page 62
  4158.  
  4159.  
  4160.  
  4161.                      APPENDIX F - CATMGR: CATDISK CATALOG MANAGER
  4162.  
  4163.         In response to requests from the many users of CATDISK, we have
  4164.         developed a simple utility that will allow you to manipulate catalog
  4165.         entries among your various catalog files without having to uncatalog
  4166.         disks from one catalog and re-catalog them in another.  With CATMGR,
  4167.         you can copy records from one catalog to another (including a brand new
  4168.         catalog), move records from one catalog to another and delete multiple
  4169.         disks from a catalog in one pass.
  4170.  
  4171.         CATMGR can have two catalog files loaded at one time.  The startup
  4172.         command for CATMGR is as follows:
  4173.  
  4174.         CATMGR CatalogFile1 CatalogFile2
  4175.  
  4176.         - where CatalogFile1 is the catalog file that you wish to be loaded on
  4177.           on the left side of the screen and CatalogFile2 is the catalog file
  4178.           that you wish to be loaded on the right side of the screen. Both of
  4179.           these parameters are optional and you can specify one, both or none
  4180.           of them on the command line.
  4181.  
  4182.         The CATMGR screen is divided into three regions.  The upper left and
  4183.         right portions show information from the summary files from the two
  4184.         active catalog files, and the lower area makes up the instruction and
  4185.         message area.
  4186.  
  4187.         The general strategy with this utility is to tag the entries that you
  4188.         wish to copy, move or delete and then select the appropriate operation
  4189.         to perform.  For copying or moving catalog entries, the side of the
  4190.         screen on which the highlight bar resides is considered the source
  4191.         side, while the other side is considered the destination side.
  4192.  
  4193.         You can tag entries in one of two ways.  The first way is to highlight
  4194.         the desired entries by using the cursor keys and by pressing the
  4195.         <Space Bar>.  CATMGR will indicate that an entry is tagged when there
  4196.         is an arrow to the left of its volume name on the screen.
  4197.  
  4198.         You can move the highlight bar around the screen by using the following
  4199.         keys:
  4200.  
  4201.         <Up Arrow>    - Moves the highlight bar up one line if possible.
  4202.         <Down Arrow>  - Moves the highlight bar down one line if possible.
  4203.         <Left Arrow>  - Moves the highlight bar over to the last position on
  4204.                         the left side of the screen.
  4205.         <Right Arrow> - Moves the highlight bar over to the last position on
  4206.                         the right side of the screen.
  4207.         <PgUp>        - Moves the highlight bar up one screenful (16 lines) if
  4208.                         possible.
  4209.         <PgDn>        - Moves the highlight bar down one screenful (16 lines)
  4210.                         if possible.
  4211.         <Home>        - Moves the highlight bar to the top of the list.
  4212.         <End>         - Moves the highlight bar to the end of the list.
  4213.  
  4214.  
  4215.  
  4216.  
  4217.  
  4218.  
  4219.  
  4220.  
  4221.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4222.  
  4223.                                       Page 63
  4224.  
  4225.  
  4226.  
  4227.         The other way to tag entries is to do so in groups.  To bring up a list
  4228.         of tagging functions available, hit the <T> key at the main menu.
  4229.         CATMGR will bring up a list with the following functions that will
  4230.         operate on the side of the screen where the highlight bar currently
  4231.         resides:
  4232.  
  4233.           <A> - This will tag ALL of the entries.
  4234.  
  4235.           <C> - This will clear the tags of ALL of the entries.
  4236.  
  4237.           <S> - You will be prompted for a wildcard specification for all of
  4238.                 the entries that you would like to be tagged.
  4239.  
  4240.           <U> - You will be prompted for a wildcard specification for all of
  4241.                 the entries that you would like tags cleared.
  4242.  
  4243.           <I> - This will "flip" the tagged status of all entries.  This is
  4244.                 useful if, for example, you wish to copy all but five of the
  4245.                 entries of a large catalog file to be copied to a new one.
  4246.                 Simply tag the five that you do not wish to copy and then
  4247.                 select this option to quickly tag the entries that you do wish
  4248.                 to copy.
  4249.  
  4250.         <Esc> - Will return you to the main menu with no further action taken.
  4251.         
  4252.         Please note that for any of the tagging operations in any method, you
  4253.         cannot tag a volume name that exists on the other side of the screen
  4254.         because a copy or move operation will result in a duplicate volume
  4255.         showing in the target catalog.  When tagging an individual entry with
  4256.         the <Space Bar>, CATMGR will warn you of this.  When performing a group
  4257.         tagging function with the <T> options, all appropriate entries will be
  4258.         tagged with duplicates ignored.  There is no warning issued in this
  4259.         case.  Given this, it is advisable to load only one catalog file into
  4260.         memory if the only operations to be performed are deletions.
  4261.  
  4262.  
  4263.         To load a different or new catalog file into either half of the screen,
  4264.         just move the highlight bar to the desired side and press the <L> (Load
  4265.         New File) key.  CATMGR will ask you for the catalog file to be loaded,
  4266.         at which point you may enter the name portion of the catalog file only.
  4267.         Do not specify a file extension in this name; CATMGR will supply the
  4268.         necessary information at the appropriate time.  By hitting the <Esc>
  4269.         key, CATMGR will return you to the main menu with no further action
  4270.         taken.
  4271.  
  4272.         Upon successful entry of a catalog name, CATMGR will attempt to load
  4273.         the summary file for that catalog into memory.  If successful, those
  4274.         entries will immediately be displayed on your screen, and the catalog
  4275.         name will appear in the title area on its particular side of the
  4276.         screen.  Any previous tags that may have been set on that side of the
  4277.         screen will be cleared.
  4278.  
  4279.         If CATMGR is unable to find the catalog file, that side of the screen
  4280.         will be cleared, and it will be indicated that a new catalog file will
  4281.         be created in the event of a copy or move operation with that side as
  4282.         the destination side.  If you do not perform a copy or move operation
  4283.         into that catalog file, no catalog will be created for that name.
  4284.  
  4285.  
  4286.  
  4287.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4288.  
  4289.                                       Page 64
  4290.  
  4291.  
  4292.  
  4293.         Once you have a grouping of catalog entries tagged for an operation,
  4294.         here are the three that you can perform:
  4295.  
  4296.         <C>opy -   hit the <C> key to activate this function.  All tagged
  4297.                    catalog entries will be copied from the source catalog to
  4298.                    the destination catalog.  If an error occurs during this
  4299.                    phase, you will get an error message and the operation will
  4300.                    be aborted.
  4301.  
  4302.                    By far, the most common error will occur when your disk
  4303.                    becomes full.  During the copy process, CATMGR will read
  4304.                    information from both catalog files and merge them together
  4305.                    in a temporary new file.  At the end of the process, all
  4306.                    three files will exist at the same time, after which the old
  4307.                    file is deleted and the new one renamed.  The net result of
  4308.                    this is that you need free disk space equal to the size of
  4309.                    the target catalog file plus the cumulative size of the
  4310.                    number of records that will be copied from the source
  4311.                    catalog.
  4312.  
  4313.                    Once this operation is successful, the summary entries from
  4314.                    the source catalog will be copied into the destination
  4315.                    summary file.  This operation is done in memory, after which
  4316.                    the new summary file is written to disk.  As a general rule,
  4317.                    if there was enough room to update the catalog file, there
  4318.                    will certainly be enough room to create a new summary file.
  4319.  
  4320.                    If an error does occur, it was probably due to a physical
  4321.                    disk error.  If this does happen, your summary file will be
  4322.                    out of synch with its catalog file, and it is probably best
  4323.                    that you exit from CATMGR and restore a backup copy of the
  4324.                    target catalog set.
  4325.  
  4326.         <D>elete - This operation will delete tagged entries from the source
  4327.                    catalog file in a bulk operation, enabling you to perform an
  4328.                    efficient cleanup operation on your catalog file in one
  4329.                    pass, rather than the un-cataloging the entries one at a
  4330.                    time in the CATDISK program itself.
  4331.  
  4332.                    To perform the deletion(s), CATMGR will read through the
  4333.                    source file and build a new catalog file, minus the tagged
  4334.                    entries, of course.  If an error occurs while the new
  4335.                    catalog file is being built, CATMGR will abandon the
  4336.                    deletion operation and leave the original catalog file
  4337.                    intact.
  4338.  
  4339.                    As in the copy operation, the most common error will be a
  4340.                    disk full error for the similar reasons as the copy
  4341.                    operation.
  4342.  
  4343.                    Once the deletion operation on the catalog file is complete,
  4344.                    the summary file will be updated to reflect the deletions.
  4345.                    Again, the same considerations to a summary file update
  4346.                    apply to the summary update operation for deletions.
  4347.  
  4348.                    If you get an error while the summary file is being updated,
  4349.                    it is advisable that you restore a backup copy of that
  4350.                    catalog file.
  4351.  
  4352.  
  4353.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4354.  
  4355.                                       Page 65
  4356.  
  4357.  
  4358.  
  4359.         <M>ove   - this operation will move the entries from the source catalog
  4360.                    to the destination catalog.  It basically combines a copy
  4361.                    operation from source to destination, followed by a deletion
  4362.                    of the entries from the source.  The move operation is the
  4363.                    most convenient way to "split" a large catalog file into two
  4364.                    smaller ones, or to "merge" two smaller catalogs into one
  4365.                    large one.
  4366.  
  4367.  
  4368.         Finally, the last option available to you from the main menu is to exit
  4369.         from CATMGR to DOS.  This is done by pressing the <Esc> key.
  4370.  
  4371.  
  4372.  
  4373.  
  4374.  
  4375.  
  4376.  
  4377.  
  4378.  
  4379.  
  4380.  
  4381.  
  4382.  
  4383.  
  4384.  
  4385.  
  4386.  
  4387.  
  4388.  
  4389.  
  4390.  
  4391.  
  4392.  
  4393.  
  4394.  
  4395.  
  4396.  
  4397.  
  4398.  
  4399.  
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4420.  
  4421.                                       Page 66
  4422.  
  4423.  
  4424.  
  4425.                APPENDIX G - DISKFILL: CATDISK OPTIMAL DISK FILL UTILITY
  4426.  
  4427.         While CATDISK provides a way to manage the information that you have
  4428.         stored in a disk library, that still doesn't give us the excuse to
  4429.         waste disk space.  Unfortunately, copying files one at a time to a
  4430.         floppy and using our eyes to read the amount of free space left on the
  4431.         target disk and using our minds to scan the list of files to be
  4432.         offloaded and find the best file to fit that "hole" is tedious at best,
  4433.         especially if the list of files to be offloaded is large.
  4434.  
  4435.         We have developed a companion program to CATDISK called DISKFILL, which
  4436.         is included with CATDISK that addresses this problem.
  4437.  
  4438.         In a nutshell, DISKFILL has the ability to offload selected files from
  4439.         a single subdirectory at a time to a collection of disks (DISKFILL is
  4440.         primarily meant for use with floppies), and copying the files to them
  4441.         in such an order that the least amount of target disk space is wasted.
  4442.  
  4443.         DISKFILL also has the ability to move files (as opposed to copy files),
  4444.         and to delete groups of files as well.  Details on all three operations
  4445.         are discussed in their own sections in this appendix.
  4446.  
  4447.         DISKFILL takes one optional command line parameter - the wildcard
  4448.         filespec that you wish to be included in a directory scan.  This
  4449.         filespec may be a CATDISK enhanced filespec as documented in sub-option
  4450.         #4 of the reports and inquiries section of this user manual.  If no
  4451.         filespec is included on the command line, the default, "*.*" is used.
  4452.  
  4453.         You may run DISKFILL from any directory on your system.  That directory
  4454.         will be the initial subdirectory scanned on startup.  The subdirectory
  4455.         and filespec to match may be changed from within the program.
  4456.  
  4457.         Please note that DISKFILL has an internal capacity to hold 8000 files
  4458.         from a given subdirectory.
  4459.  
  4460.         Once DISKFILL has loaded, it will scan the current directory and
  4461.         present a list of files that match the filespec given.  The procedure
  4462.         here is to tag the files that you wish to be manipulated and select an
  4463.         operation to perform on them.  As the initial or new directory is
  4464.         scanned, DISKFILL automatically selects ALL files for manipulation, as
  4465.         this selection will undoubtedly be the most common.
  4466.  
  4467.         You can tag files in one of two ways.  The first way is to highlight
  4468.         the desired file by using the cursor keys and by pressing the
  4469.         <Space Bar>.  DISKFILL will indicate that a file is tagged when there
  4470.         is an arrow to the left of its filename name on the screen.
  4471.  
  4472.         You can move the highlight bar around the screen by using the following
  4473.         keys:
  4474.  
  4475.         <Up Arrow>    - Moves the highlight bar up one line if possible.
  4476.         <Down Arrow>  - Moves the highlight bar down one line if possible.
  4477.         <PgUp>        - Moves the highlight bar up one screenful (14 lines) if
  4478.                         possible.
  4479.         <PgDn>        - Moves the highlight bar down one screenful (14 lines)
  4480.                         if possible.
  4481.         <Home>        - Moves the highlight bar to the top of the list.
  4482.         <End>         - Moves the highlight bar to the end of the list.
  4483.  
  4484.  
  4485.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4486.  
  4487.                                       Page 67
  4488.  
  4489.  
  4490.  
  4491.         The other way to tag entries is to do so in groups.  To bring up a list
  4492.         of tagging functions available, hit the <T> key at the main menu.
  4493.         DISKFILL will bring up a list with the following functions:
  4494.  
  4495.           <A> - This will tag ALL of the files.
  4496.  
  4497.           <C> - This will clear the tags of ALL of the files.
  4498.  
  4499.           <S> - You will be prompted for a wildcard specification for all of
  4500.                 the files that you would like to be tagged.
  4501.  
  4502.           <U> - You will be prompted for a wildcard specification for all of
  4503.                 the files that you would like the tags cleared.
  4504.  
  4505.           <I> - This will "flip" the tagged status of all files.  This is
  4506.                 useful if, for example, you wish to copy all but five of the
  4507.                 files if a long list to be offloaded. Simply tag the five that
  4508.                 you do not wish to copy and then select this option to quickly
  4509.                 tag the entries that you do wish to copy.
  4510.  
  4511.         <Esc> - Will return you to the main menu with no further action taken.
  4512.  
  4513.  
  4514.         Other options available from the main menu are:
  4515.  
  4516.         <P> - Change Pattern:  DISKFILL will prompt you for a new filespec to
  4517.               match when scanning the directory.  This is handy if you only
  4518.               wish to have a grouping of files from the current subdirectory to
  4519.               be included in the point and shoot list.  Note that after the
  4520.               directory has been re-scanned, ALL files will be tagged for
  4521.               manipulation.
  4522.  
  4523.         <S> - Change Subdirectory:  DISKFILL will prompt you for a new
  4524.               subdirectory to be scanned (the current pattern as noted at the
  4525.               top of the screen will be used).  Note that after the directory
  4526.               has been scanned, ALL files will be tagged for manipulation.
  4527.  
  4528.  
  4529.         DISKFILL currently has three operations that you can perform on the
  4530.         tagged files:
  4531.  
  4532.         <C> - Copy:  When this option is selected, DISKFILL will ask you for
  4533.                      the drive of the target disk(s) that will received the
  4534.                      tagged files.  Typically, this will be drive A: or drive
  4535.                      B:, but we have allowed any available drive letter in your
  4536.                      system due to the fact that there may be an external
  4537.                      floppy disk using a device driver that is available.
  4538.  
  4539.                      Once you have selected the target drive, DISKFILL will
  4540.                      then prompt you to insert a disk in the target drive.  If
  4541.                      you do not wish to continue with the operation, hit <Esc>
  4542.                      to return to the main menu.  Optionally, you may press the
  4543.                      <S> key to shell out to DOS.  This is handy if you need to
  4544.                      check something outside of the DISKFILL program before
  4545.                      proceeding.  Once you are ready, hit any other key to
  4546.                      proceed.
  4547.  
  4548.                      This prompt will appear before each disk necessary to
  4549.                      complete the operation is to be inserted.
  4550.  
  4551.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4552.  
  4553.                                       Page 68
  4554.  
  4555.  
  4556.  
  4557.                      Before DISKFILL begins to copy files to each disk, it will
  4558.                      examine the disk to determine capacity and to check to see
  4559.                      if any files or sub-directories are present on the disk.
  4560.                      If a disk error occurs at this stage, DISKFILL will assume
  4561.                      that the disk is not formatted and will bring up a message
  4562.                      indicating that it thinks that the disk is not formatted.
  4563.  
  4564.                      You have three options at this point:
  4565.  
  4566.                      1) You may hit <S> to shell out to DOS to either examine
  4567.                         the disk, or to invoke your favorite program to
  4568.                         facilitate formatting that diskette.  We have not built
  4569.                         in the facility to load any particular disk formatting
  4570.                         software, as there are many alternatives to the DOS
  4571.                         format command, and the selection of a given program is
  4572.                         a matter of personal preference.  This also leaves open
  4573.                         the possibility of using a disk formatting program that
  4574.                         has the ability to format more capacity on a disk than
  4575.                         normal.
  4576.  
  4577.                         When you are ready to continue with the copy operation
  4578.                         after shelling out to DOS, type "EXIT" and hit <Enter>
  4579.                         to return back to the prompt.
  4580.  
  4581.                      2) You may hit <Esc> to abort the copy operation and
  4582.                         return to the main menu.
  4583.  
  4584.                      3) You may hit any other key to try a new diskette, at
  4585.                         which time the disk determination will be repeated.
  4586.  
  4587.                      If the target disk has files on it, you will be presented
  4588.                      with another set of options that will allow you to make a
  4589.                      decision on what to do next:
  4590.  
  4591.                      1) You may hit <V> to view the directory of the target
  4592.                         disk to verify that it is the one that you intended to
  4593.                         insert in the drive.  The DOS "DIR/P" command will be
  4594.                         issued.
  4595.  
  4596.                      2) You may hit <S> to shell to DOS.  This option is
  4597.                         available to allow you to examine the situation more
  4598.                         closely, perhaps to examine the directory of the disk
  4599.                         and see if you have inserted the correct diskette.
  4600.                         When you return from the DOS shell, you will be left at
  4601.                         this prompt from which you may take appropriate action.
  4602.  
  4603.                      3) You may press <E> to have DISKFILL erase all visible
  4604.                         files and subdirectories from that disk before
  4605.                         proceeding with the copy operation.
  4606.  
  4607.                         IF YOU ARE USING A TARGET DRIVE OTHER THAN A: or B:,
  4608.                         EXERCISE THIS OPTION WITH EXTREME CAUTION.  IF THE
  4609.                         TARGET DRIVE HAPPENS TO BE A HARD DISK, ALL VISIBLE
  4610.                         FILES AND SUBDIRECTORIES WILL BE ERASED.  YOU HAVE BEEN
  4611.                         WARNED!
  4612.  
  4613.                      4) You may press <T> to try another diskette.  You will
  4614.                         then be returned to the disk insertion prompt.
  4615.  
  4616.  
  4617.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4618.  
  4619.                                       Page 69
  4620.  
  4621.  
  4622.  
  4623.                      5) You may press <Esc> to Abort the copy operation
  4624.                         altogether and return to the main menu.
  4625.  
  4626.                      6) You may press any other key to continue on with the
  4627.                         copy operation.  DISKFILL will then add files to those
  4628.                         that already exist on the target diskette as available
  4629.                         space allows.
  4630.  
  4631.                      Once all is ready, DISKFILL will proceed to copy files to
  4632.                      the target diskette.  As each file is copied, it will be
  4633.                      highlighted in the list and a progress indicator will
  4634.                      appear in the instruction area of the screen keeping you
  4635.                      informed of the progress of the copy.  DISKFILL will
  4636.                      buffer as much of the source file into memory as it can
  4637.                      before writing it out to the target diskette in order to
  4638.                      facilitate speed.
  4639.  
  4640.                      As DISKFILL copies files, an indicator at the bottom of
  4641.                      the screen will indicate how much of the read and write
  4642.                      operations are complete.  The indicator beside each status
  4643.                      indicator that is flashing will indicate what DISKFILL is
  4644.                      currently doing.
  4645.  
  4646.                      As each file is successfully copied to the target, it will
  4647.                      be "un-tagged" in the file list.  This way, if the copy
  4648.                      process is interrupted or aborted for any reason, you can
  4649.                      effectively pick up where you left off, as the tagged
  4650.                      files will be those that were not copied.
  4651.  
  4652.                      The capacity left over on the target disk will be updated
  4653.                      as each file is copied to it.  Additionally, the
  4654.                      statistics on the right side of the screen will indicate
  4655.                      how many files have yet to be copied.
  4656.  
  4657.                      If a disk error occurs when copying a file to the target,
  4658.                      that copy will be aborted.  DISKFILL will make an attempt
  4659.                      to remove that file from the target disk, although this
  4660.                      cannot be guaranteed.  The file that was being copied at
  4661.                      the time of the error will remain in the "hit list" to be
  4662.                      copied to a subsequent disk.  You will then be returned to
  4663.                      the prompt for a new disk with which to continue the copy
  4664.                      operation.
  4665.  
  4666.                      It may be advisable to shell out to DOS at this point with
  4667.                      the <S> command to check the disk and perhaps run a
  4668.                      diagnostic program on the target disk in order to map out
  4669.                      any bad areas of the disk.  If this proves to be the cause
  4670.                      of the error, you may be able to continue the copy
  4671.                      operation with that disk.
  4672.  
  4673.                      When DISKFILL has determined that no more files from the
  4674.                      selected list will fit on the target disk, it will return
  4675.                      to the disk insertion prompt where you may continue on
  4676.                      with a new diskette, or abort the operation right there.
  4677.  
  4678.                      When all selected files have been copied to the target
  4679.                      directory, you will automatically be returned to the main
  4680.                      menu where the updated file list will be displayed.  If
  4681.                      all went well, there should be no more files tagged.
  4682.  
  4683.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4684.  
  4685.                                       Page 70
  4686.  
  4687.  
  4688.  
  4689.                                           IMPORTANT NOTES
  4690.  
  4691.                      DISKFILL will work best when there is a mix of large and
  4692.                      small files available for copying to the target disk(s),
  4693.                      as DISKFILL will be able to use the smaller files to fill
  4694.                      in the holes left over by the larger files.
  4695.  
  4696.                      It is not necessary to use disks of the same capacity
  4697.                      throughout an entire copy operation.  For example, in a
  4698.                      high capacity 3.5" drive, you could use a mix of 1.44Mb
  4699.                      and 720K floppies.  DISKFILL will copy files to it as the
  4700.                      capacity of each inserted disk allows.
  4701.  
  4702.                      If you have one or several files that are too big to fit
  4703.                      on a target drive, the insert disk prompt will simply be
  4704.                      repeated over and over again until you abort, as DISKFILL
  4705.                      is a very patient program and will wait until a suitable
  4706.                      disk is inserted in the drive.
  4707.  
  4708.                      If you have been using low density media, you may need to
  4709.                      switch to a higher capacity disk format in order to
  4710.                      accommodate the file.
  4711.  
  4712.                      If you have a file that will not fit on a disk of any
  4713.                      capacity, DISKFILL will not be able to offload it.  If the
  4714.                      file is not compressed, you may wish to use one of the
  4715.                      many archive utilities supported by CATDISK to compress
  4716.                      the file to a size that may fit on a target disk, or
  4717.                      alternatively, you may wish to use a file split/merge
  4718.                      utility to break the file down into smaller, more
  4719.                      manageable sub-files.
  4720.  
  4721.  
  4722.         <M> - Move:  The MOVE operation works exactly like the copy operation
  4723.                      except that each file being offloaded is erased after the
  4724.                      copy operation is complete.  If a disk error occurs during
  4725.                      the copying part of the operation, the file involved is
  4726.                      left intact in the source directory where an attempt can
  4727.                      be made to move it to another disk later on in the
  4728.                      operation.
  4729.  
  4730.                      THE MOVE OPERATION IS THE PREFERRED METHOD OF OFFLOADING
  4731.                      FILES TO FLOPPIES.  It is also safe due to the fact that
  4732.                      the only time that the source file is erased is when it
  4733.                      has been successfully copied to the target disk.
  4734.  
  4735.         <D> - Delete:  This operation will quickly delete all selected files
  4736.                        from the source directory.  Once a file has been
  4737.                        deleted, DISKFILL cannot recover it, although it is
  4738.                        possible to use one of the many file unerase utilities
  4739.                        on the market to get the file back.
  4740.  
  4741.                        Due to the potential severity of using this function,
  4742.                        you will be asked for verification before continuing on
  4743.                        with the operation.
  4744.  
  4745.         NOTE:  With the move and delete operations, DISKFILL will not be able
  4746.                to erase a file marked "READ-ONLY".
  4747.  
  4748.  
  4749.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4750.  
  4751.                                       Page 71
  4752.  
  4753.  
  4754.  
  4755.                         APPENDIX H - CATDISK Companion Programs
  4756.  
  4757.         Over the past 5 years, CATDISK has grown steadily in popularity, and
  4758.         has become one of the leading cataloging programs available, due
  4759.         largely in part that it does not try to do everything under one roof.
  4760.         The philosophy behind CATDISK has always been and always will be to
  4761.         provide a reliable, simple to use cataloging utility that performs the
  4762.         essential tasks of identifying the location(s) of individual files in a
  4763.         collection of disks.
  4764.  
  4765.         I will be the first to admit that there are many new functions and
  4766.         reports that CATDISK could do and does not due to the above mentioned
  4767.         philosophy.
  4768.  
  4769.         Several enterprising individuals have created companion programs to
  4770.         CATDISK that enhance its functionality.  They are briefly described
  4771.         here, along with the authors' names and addresses.
  4772.  
  4773.         All of these programs may be obtained by registered CATDISK users (as
  4774.         per the BBS support option) on the support board, The Shareware
  4775.         Connection, in file area 1 on the main board.  You may also be able to
  4776.         find these programs on your local bulletin board systems as well.
  4777.  
  4778.         CATCOMP
  4779.  
  4780.         Catcomp is a handy utility that has the capability of taking a text
  4781.         file such as a BBS listing and comparing its contents with a CATDISK
  4782.         catalog file and generating a listing of what files you have in your
  4783.         catalog that are not listed in the text file.  Catcomp can also tell
  4784.         you what files are listed in the text file that you do not have, as
  4785.         well as tell you what files are duplicated.
  4786.  
  4787.         This utility is extremely handy when you are dealing with a bulletin
  4788.         board system that imposes an upload/download ratio on its members.  On
  4789.         such systems, it is commonplace for users to rename the same file or
  4790.         make a small change to it, and upload the duplicate to the board in
  4791.         order to gain more download capability.  Such practices are not in the
  4792.         best interests of either the bulletin board system or its members.
  4793.  
  4794.         That's where Catcomp comes in very handy.  Its reporting capabilities
  4795.         will allow you to determine what files you have that are legitimately
  4796.         not on that board.  I'm sure that the use of this utility in such
  4797.         circumstances will help you develop a good rapport with the sysop(s) of
  4798.         those boards.
  4799.  
  4800.         Catcomp is menu-driven and very easy to use.
  4801.  
  4802.          Author:  Wayne A. Davis                       Catcomp is shareware,
  4803.         Address:  17617 N. 9th St., #2076              and a $10 registration
  4804.                   Phoenix, AZ                          fee is requested for the
  4805.                   USA  85022-1943                      program if you find it
  4806.           Phone:  (602) 482-8216                       useful.
  4807.  
  4808.         Catcomp can also be obtained from "The Chalkboard BBS" in Phoenix at
  4809.         (602) 997-1392 or (602) 395-9726.  Log in with:
  4810.  
  4811.         First Name: CATCOMP <Enter>
  4812.          Last Name: <Enter>
  4813.           Password: CAT <Enter>
  4814.  
  4815.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4816.  
  4817.                                       Page 72
  4818.  
  4819.  
  4820.  
  4821.         CAT-STAT
  4822.  
  4823.         Cat-stat is a CATDISK-specific program that has two primary functions.
  4824.         It can scan your catalog file and generate some handy statistics on the
  4825.         data in your catalog file.  Ever wondered just how many megabytes worth
  4826.         of floppies you have in your collection?  This program will tell you
  4827.         that.  Its primary function, though, is to compare two CATDISK catalog
  4828.         files and tell you what files are in catalog file "A" that are not in
  4829.         "B" and vice versa.  It's great to have if you are trading files with a
  4830.         friend.
  4831.  
  4832.         Again, this program is menu-driven and very easy to use.
  4833.  
  4834.         Cat-stat is written by George Wilken and Bill Guy, and a $10 shareware
  4835.         registration fee is requested if you decide to use it.
  4836.  
  4837.         Send registrations to:  George Wilken
  4838.                                 702 Deering Drive
  4839.                                 Akron, OH
  4840.                                 USA  44313
  4841.  
  4842.         Questions or comments may be left for the authors on CompuServe at
  4843.         71450,3172.
  4844.  
  4845.  
  4846.         DISK LABEL SYSTEM (DLS)
  4847.  
  4848.         One of the many requests that I have received for CATDISK to include is
  4849.         a facility to print disk labels.  The main reason that CATDISK does not
  4850.         currently have this capability is mainly due to our philosophy of
  4851.         providing a single-purpose utility that does what it does best.
  4852.  
  4853.         The good news is that this program is capable of producing disk labels
  4854.         directly from your CATDISK catalog file(s).  Additionally, it can read
  4855.         the directory information directly from a diskette if inserted in the
  4856.         floppy drive.  DLS can produce labels for 5.25" and 3.5" diskettes, as
  4857.         well as disk inserts for 5.25" diskettes.
  4858.  
  4859.         DLS is quite powerful, but is very easy to use.
  4860.  
  4861.         Several popular printers are supported.
  4862.  
  4863.         DLS is shareware, and a $15 registration fee is requested if you find
  4864.         the program useful.
  4865.  
  4866.          Author: James A. Clark
  4867.         Address: 2130 Knollshire Road
  4868.                  Cedar Rapids, IA
  4869.                  USA  52402
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4882.  
  4883.                                       Page 73
  4884.  
  4885.  
  4886.  
  4887.                             APPENDIX I - CATDISK PLUS
  4888.  
  4889.         Since its initial release in October of 1986, CATDISK has gone through
  4890.         many changes and has received tremendous support from the many
  4891.         corporations and individuals who have sent in their registration fees.
  4892.         CATDISK is currently in use world-wide in more applications than I
  4893.         could have possibly dreamed of.  Judging from this response, I can
  4894.         safely say that the SHAREWARE system is alive and flourishing as a
  4895.         viable means of making quality software available at reasonable cost.
  4896.  
  4897.         Along the way, many individuals have requested features in the program
  4898.         that are not feasible in the current design of CATDISK.  In creating
  4899.         this program, I set out to make the operation as simple and automatic
  4900.         as possible.  Those requests that melded in with the current design
  4901.         have been implemented, and those that will compliment same will be
  4902.         implemented in the future.
  4903.  
  4904.         However, there have been numerous requests for features that would
  4905.         complicate the design of the shareware version of CATDISK - good
  4906.         requests.
  4907.  
  4908.         Therefore, it is with great pleasure that we are announcing the
  4909.         development of a new commercial program, CATDISK PLUS, which will be
  4910.         produced by my software company, The DATAMEN Inc.  See the README.1ST
  4911.         file from your CATDISK package for details on its availability.
  4912.  
  4913.         Please keep in mind that this shareware version will continue to be
  4914.         enhanced and supported - it's still "my baby"!
  4915.  
  4916.         Some of the features include:
  4917.  
  4918.          . A windowed desktop environment with pull down menus for ease of use.
  4919.          . Online context-sensitive help.
  4920.          . Support for the 43 line EGA and the 50 line VGA screen modes.
  4921.          . Full color customization.
  4922.          . All the functional features of the current shareware release.
  4923.          . The ability to selectively catalog files from your disks via three
  4924.            methods, all of which can be used at once:  inclusion filespecs,
  4925.            exclusion filespecs, and a point and shoot list of files read.
  4926.          . A greater variety of reporting features will be available as well
  4927.            as a custom report generator where you can design your own reports.
  4928.          . Comment entries for each disk in the catalog.
  4929.          . Longer file comments.
  4930.          . Greater capacity for catalog size (5000 disks, 65000 files).
  4931.          . A full blown disk manager supporting all the archive file formats
  4932.            that CATDISK currently does.
  4933.          . The ability to print user-defined disk labels and jacket inserts.
  4934.          . Plus many more!
  4935.  
  4936.         One major consideration is that CATDISK PLUS will require a hard disk.
  4937.         Suggested retail price for this product is $69.95 US + $8.00 for
  4938.         shipping and handling.  Dealer inquiries are welcome.
  4939.  
  4940.         Please address all inquiries to:
  4941.  
  4942.               The Datamen                    Phone: (519) 888-6763
  4943.               405 Barrington Lane              FAX: (519) 884-4887
  4944.               Waterloo, ONTARIO                BBS: (519) 888-6924
  4945.               Canada   N2T 1H9
  4946.  
  4947.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  4948.  
  4949.                                       Page 74
  4950.  
  4951.  
  4952.  
  4953.                          APPENDIX J - OTHER PRODUCTS AVAILABLE
  4954.  
  4955.         For all you avid golfers out there, I have released a golf handicap
  4956.         system, called HANDICAP II, that goes way beyond just calculating a
  4957.         simple golf handicap.
  4958.  
  4959.         Among the many features of this program are:
  4960.  
  4961.           . Pull down menus for ease of use.
  4962.           . On line context sensitive help.
  4963.           . Storage capacity for up to 400 different golf courses.
  4964.           . Storage capacity for up to 128000 rounds of golf (if you exceed
  4965.             this number, I want to meet you!).
  4966.             (score and number of putts on each hole can be logged)
  4967.           . Instant retrieval of past played games, and the ability to browse
  4968.             through them.
  4969.           . An expanded handicap card that is more informative than a standard
  4970.             handicap card.
  4971.           . A report showing your average score on each hole on each course.
  4972.             - good for spotting habitual trouble holes.
  4973.           . A report showing your average putts on each green on each course.
  4974.             - good for spotting habitual troublesome greens.
  4975.           . A report showing how often you hit each green in regulation.
  4976.             - good for analyzing your tee-to-green game on each hole.
  4977.           . Many more statistical reports of interest to you.
  4978.           . Full housekeeping routines to correct mistakes (but I'll bet that
  4979.             you never make any, right?!?)
  4980.  
  4981.           . ALL reports may be viewed on the screen or printed on your
  4982.             printer.
  4983.  
  4984.           . Pop up windows are used extensively, adding to the ease of use of
  4985.             the program.
  4986.  
  4987.         We also have a clubhouse version available with all of the above plus:
  4988.  
  4989.           . A simple date-differential entry system for those who do not wish
  4990.             to have all the detail of the enhanced reports.
  4991.           . Capacity to maintain handicaps for up to 128000 members (you are
  4992.             only limited by disk size).
  4993.           . Full system manager functions available only to authorized users.
  4994.           . A handicap listing (in alphabetical order by member name) of the
  4995.             handicaps of all the members in the system.
  4996.  
  4997.                                   Ordering Information
  4998.  
  4999.         The GOLFERS version of HANDICAP II is available as shareware for $30
  5000.         directly from myself (Rick Hillier), and the CLUB HOUSE version is
  5001.         available for $295.00 (which includes a bound, printed manual) from the
  5002.         address below.
  5003.  
  5004.         They may be ordered from:  The Datamen, Inc.
  5005.                                    405 Barrington Lane
  5006.                                    Waterloo, Ontario
  5007.                                    Canada   N2T 1H9
  5008.                            Phone:  (519)-888-6763
  5009.                              FAX:  (519)-884-4887
  5010.                              BBS:  (519) 888-6924
  5011.  
  5012.  
  5013.      Disk Catalog System (CATDISK) V6.00  Copr (C) 1986, 1992 by Rick Hillier
  5014.  
  5015.                                       Page 75
  5016.  
  5017.